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Preface 


Tuning UNIX® operating systems is complex and exacting, and 
should only be attempted by an experienced system administrator. 
Numerous variables must be considered to achieve optimum 
performance. 


Know Your System Limitations 


Any operating system has limitations. A UNIX operating system 
can readily find those limitations, especially those of secondary 
storage or disk drive access. The hierarchical structure of the file 
system allows maximum flexibility in the organization of storage 
and retrieval of files. File I/O has a high overhead, because of 
UNIX file systems. After some time and numerous additions or 
deletions to a file system, the unallocated blocks tend to become 
randomized, hampering the software interleave of disk blocks 
specified when the file system was made. 


Another major limitation of UNIX operating systems concerns the 
allocation of memory to user processes. UNIX systems manage 
memory as a resource shared by all user processes and the 
operating system. If the size of all user processes and the 
operating system exceed the size of main memory, pages of 
memory must be "paged out" to a disk swap area. This paging, if 
excessive, severely impacts system performance. 


The last limitation to be considered is terminal I/O. Most vendors 
today allow configurations with intelligent terminal controllers. If 
no such option is available for your machine and there is a 
moderate to high level of terminal activity, the Central Processing 
Unit (CPU) time will be spent handling character interrupts to and 


UNIX is a registered trademark of AT&T in the USA and other 
countries. 
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from terminals. This problem is mentioned last, since most vendors 
provide solutions. 


Hardware Considerations 


Disk 


In most architectures the throughput of I/O bus channels far 
exceeds the capabilities of the I/O subsystem. Generally, the 
more disk drives that can be configured on the system, the better 
the disk throughput levels that can be expected, because 1/O 
requests from the operating system to these electromechanical 
devices can be shared, resulting in a reduction of time spent 
waiting for responses. 


Additional disk controllers may help. With less contention for an 
area of disk, less seeking by the disk arm is required. (A seek is 
defined as the process of the disk drive going to a new position in 
Oreparation for a read or write request. A seek usually takes the 
greatest amount of time when the operating system issues a 
request to a disk.) 


If more than one disk drive is attached to a controller, it is 
imperative that both hardware and software support overlapping 
seeks. Overlapping seeks enable a seek request to be issued to a 
disk drive and, before the seek is complete, another disk can 
receive a similar request while the first disk is serviced. Many 
vendors still have problems implementing overlapping disk seek 
requests. 


Although hardware generally supports the overlap requests, 
software driving the disk subsystem sometimes does not. 
Typically, it has been observed that a drive can be blocked from 
transferring data while another drive is still seeking. If overlap 
seeking is not clearly implemented, an additional controller may 
help for the short term; however, an additional controller is usually 
cost prohibitive, so a redesign of the software driver is more 
appropriate. True overlapping of seek requests can enhance disk 
throughput tremendously. 
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Memory 


If adding more memory is not possible, then software must 
minimize the impact. If it is possible, more memory should be 
added to eliminate or reduce swapping and provide for future user 
loads. 


Software Considerations 


For file system I/O, UNIX operating systems provide a disk caching 
capability that uses a least-recently-used type of algorithm. In 
addition to the disk caching, UNIX systems also provide for 
references to disk cache by way of hashing techniques. 


Hashing is a quick way to reference one particular item in a great 
number of items. A simple technique is to take the first three or 
four digits of an address and make them an entry point for all 
addresses that have the same first three or four digits. This 
technique enables the system to reference an address and 
associated block quickly. 


If two different disk blocks hash to the same place in the table, 
then chaining, or linking of the disk blocks together through a 
singly linked list, occurs. This chaining effect should be avoided 
by increasing the hashbuf number (an entry in the system buffer 
hash table) or reducing the number of buffers used. One entry for 
every buffer configured is usual. 


For example, if there are 500 buffers, there should be 512 
hashbuf; for 1000 buffers there should be 1024 hashbuf; for 2000 
buffers there should be 2048 hashbuf. (See Table 1-1, 
"Configuration Parameters Summary" for the correct value for your 
machine.) The hashbuf number should be a power of 2, as any 
excess wastes memory space. Several kernel configurations 
should be tried with the job mix to determine the best 
configuration. 


UP-12715 Rt Preface 3 


Preface 


ISS EAN TY ET SL TE NII NI AN NS SS ORE EE 


More buffers are not necessarily better. Increasing the number of 
buffers also increases the probability of swapping because the 
amount of memory available to user processes is reduced. 
Sometimes, however, increasing the number of buffers is 
preferable even though it increases swapping. Each case depends 
on how efficiently the software driver and associated hardware can 
handle basic or raw I/O. 


When the system finds a requested disk block in its buffer cache, 
it is termed a "cache hit." Cache hit rates should be 90 to 96 
percent on read requests, and 90 to 80 percent on write requests 
for optimum performance. If average hit rates fall below this level, 
increasing the amount of disk buffer cache is probably required. 
These numbers may not be accurate for benchmarks that do 
much sequential I/O. 


Another consideration is use of the sticky bit process by executing 
the chmod command with the +t option on the most frequently 
used programs. For example, to use the sticky bit with the Is 
command, the syntax would be: 


chmod +t /bin/Is 


The sticky bit process copies an image of the program from a 
UNIX file system to the swap area when the program is first called. 
Subsequent calls to execute that program are completed quickly 
as the system looks first for the program in the swap partition 
instead of through a UNIX file system. The increased speed is 
accounted for in several ways. 


As mentioned before, a UNIX file system is much slower than the 
capabilities of raw devices such as the swap area. In addition, the 
request to load the program is done with one I/O request instead 
of paging in the program one block at a time through a UNIX file 
system. The program remains in the swap area until the system is 
rebooted. 


The disadvantage of using sticky bit procedures is that less swap 
space is available to handle processes being swapped out of main 
memory. The operating system will panic if the swap area is 
exhausted. However, if disk capacities continue to increase, it 
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helps to set the sticky bit for all frequently used programs. 
Empirical data indicates that performance improves as much as 40 
percent with liberal use of sticky bit procedures on a heavily 
loaded system. 


File System Organization 


Creating a file system with the right options is critical for a system 
to perform well. As mentioned previously, sticky bit procedures 
help to avoid the penalties associated with a file system. Before 
you can make the file system, however, you must know several 
specific items of information. 


First, you must obtain the software interleave for disk operations. 
Software interleave is the time required to complete a system 
request for I/O to disk, its subsequent completion, plus the time 
required for the next operation relative to the revolution of the 
disk. This relationship varies from disk to disk, depending primarily 
on make and model of the disk drive. 


Default values are reliable for most file systems; there are times, 
however, when default values are not appropriate. If you do not 
expect the kernel to change radically, you can take advantage of 
smaller gap settings. What is best for any system can be checked 
out simply by creating an empty experimental file system and 
timing a large read and write to the character device defined in 
/dev for that file system. The gap setting that gives you the best 
time is one you want to use. For example: 


foriint1234... 26 

do 

/etc/umount /dev/dsk/c0d1s0 

/etc/mkfs /dev/dsk/c0Od1s0 3000 $i 624 >/dev/null 2>/dev/null 
/etc/mount /dev/dsk/c0d1s0O /mnt >/dev/null 2 > /dev/null 
cp /w/mike/bigfile /mnt/bigfile 

echo 

echo Read time for $i sector interleave: 

echo 

time cp /mnt/bigfile /dev/null 

done 
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Optimal interleave is to be determined in single-user 


mode. The previous example is for a Control Data 
Corporation 515-megabyte disk drive. The real value 
derived from the time command is the deciding factor 
in establishing the optimal interleave. 


The number of inodes required for the file system must be 
determined. An inode is control information for a file in a UNIX file 
system. The control information includes items such as mode and 
type of file, number of links, user identification number, group 
identification number, number of bytes in the file, disk block 
addresses, time last accessed, time last modified, and time of 
creation. 


A large advantage can be gained over typical default settings by 
reducing the number of inodes in a file system. This reduction 
greatly decreases the time required to retrieve the proper inode 
and subsequent file. To determine how many inodes to configure 
for, do a df command with the -t option on the file system you 
want to reconfigure. If the file system is empty, load it and then 
follow the procedure described previously. If your file system is 
primarily used for reading, rather than reading and writing, allocate 
no more than 3 to 5 percent more than the total number used. If 
the file is used for both reading and writing, then the 
determination requires an experienced administrator (or much trial 
and error). 


For example, creating a /tmp file system may require many read 
and write operations, but the number of inodes required may not 
be as many as you might expect. At peak load times, you should 
take several snapshots of usage with the df command to obtain 
the inode count used. When this information is obtained, it is a 
safety factor to add 10 to 20 percent of the number of inodes 
used to the total. Using less of a safety factor could cause trouble 
later. 
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When the optimal software interleave and the number of inodes 
required have been determined, the file system can be 
constructed by use of the mkfs command. After the file system 
construction, the most frequently used files should be copied over 
first to the new file system to reduce the amount of searching and 
seeking to these commands. Command frequency can be 
obtained by use of the sar command. (The sar command is 
discussed in the "System Utilities" section.) 


It is important in the file system layout to consider the balancing of 
the load across disk controllers and disk drives. For example, with 
a 3-disk drive and a 2-disk controller system, it is an advantage to 
put the third drive on the second controller, because the first 
controller is then dedicated to the first drive, on which is typically 
the system disk. The system disk includes the root file system 
and the swap area. 


As the system is loaded to a point that invokes much swapping, 
having the first controller dedicated to the first drive is preferable 
because the system disk, when transferring data, doesn’t have to 
contend with any other disk for the controller. With four drives, 
the least active drive should be attached to the same controller as 
the system drive. 


Another item to consider is the size of the file system. The 
smallest file system you can use successfully is best. 


Seek time is reduced significantly when the disk arm has to travel 
a shorter distance. For example, the swap area begins at the end 
of the root file system. If another active file system follows the 
swap area, then numerous seeks past the swap area from the 
active file system to the root file system and back again occur. 
The disk arm has to travel across much open space if the swap 
area is large. 


If, however, the disk drive is large and the configured swap area is 
large, then sticky bit procedures have a double advantage: first, 
programs are executed from the swap area instead of through a 
file system; second, if the most frequently used root file system 
executables have the sticky bit turned on, the need to seek past 
the swap area is eliminated. File systems should remain small and 
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close to other active file systems. It is often an advantage to put 
the largest file system closest to the spindle of the disk drive, so 
that the operating system does not have to seek past it, and it will 
only seek to what it needs to complete its task in that particular file 
system. 


Another tuning requirement is remaking volatile file systems. A 
volatile file system services numerous requests for reading, writing, 
and removing of files. An excellent example is /tmp. The /tmp file 
system should be created every time the system is booted using 
the /etc/re file or some other means, because UNIX file systems 
decay with usage as a result of the free block chain becoming 
randomized when files are created and deleted by numerous 
users. The utility dcopy reorganizes the free block chain. The 
same thing can be accomplished by way of a tape archival that 
does not copy inodes, superblocks, or whole file systems. The tar 
or cpio utilities are beneficial to use. 


The file system used by System V.2 has not changed greatly since 
Version 7, except for increased block size for greater throughput. 
System V.2 can handle either a 512-byte block or 1024-byte block 
file system. The newer 1024-byte file system has a special stamp 
embedded in the file system control structure or superblock to 
notify the system that it is a 1024-byte file system. The older 512- 
byte system is recognized by the lack of any stamp. Similarly, old 
file systems would not have to change and would remain 
compatible with the newer system. 


Despite heuristic algorithms that return freed blocks to the 
unallocated block list, as a file system ages, effective throughput 
decreases because of the random ordering of the block list and 
wasting of disk revolutions. As mentioned previously, System V 
has a utility called dcopy that can place the file system back in 
order. This utility requires an additional device in which to put an 
appropriate file system to contain the results of dcopy and the old 
file system. 


Preface 8 UP-12715 R1 


Preface 


system Utilities 


You can monitor your system efficiency with the use of the sar 
command. 


CPU usage can be determined with the sar -u command. If the 
CPU is busy, the sar output breaks down the percentage of time 
spent in either system mode (%sys) or in user mode (%usr). If the 
CPU is idle, the appropriate time spent idle is shown as a 
percentage of time idle (%/d/e). 


Another important column (%wio) shows the percentage of time 
spent waiting for I/O operations. If the %wio value is greater than 
6 or 7 on a 5000/20/30/35/40/50/55 system, then a disk bottleneck 
exists. If the percentage of idle time is greater than 10 on any 
system, the CPU can keep up with the load. It is important to 
note that usage is mostly cyclic when examining the sar report. 


The overall average may be deceptive and not reflect the real 
trouble times. For example, if the sampling data was obtained 
over a 24-hour period, the data might typically be skewed by 
extreme use during the hours of 10:00 am to 4:00 pm. The data 
may show an average usage over 24 hours, but when the data is 
taken by individual hours, severe load problems may be disclosed. 
The data to be evaluated should only take the peak load hours to 
give reliable results for tuning. 


Buffer cache efficiency can be determined with the sar -b option. 
The two most important columns to look at are %rcache and 
%weache. As mentioned previously, the read cache hit rate 
(%rcache) should be between 90 and 96 percent. The write cache 
hit rate (%wcache) should be over 80 to 90 percent. If the 
percentages fall below these levels and the %wio is large, the 
system can benefit greatly by increasing the number of system 
buffers. 
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sar -b (Part 1) 


bread/s read/s “%rcache- bwrit/s 


18:00:06 14 163 64 5 
19:00:06 9 191 66 6 
20:00:06 3 193 62 5 
Average 9 182 64 5 


sar -b (Part 2) 


Iwrit/s %weache’ pread/s_ pwrit/s 


18:00:06 31 v2 5 > 
19:00:06 36 52 3 3 
20:00:06 38 56 6 6 
Average 35 23 5 2 


This is an example of a system for which a system administrator 
might want to configure more buffers into the kernel. Note the 
%rcache and %wcache are not at acceptable limits. The sar -d 
command shows the balance of the disk I/O across the disk drives. 
The percent busy (%busy) suggests how much time the device is 
spending servicing I/O requests. The other two important items 
for tuning are avwait and avserv. avwait is the average time in 
milliseconds that transfer requests must wait on the queue. avserv 
is the average time for a transfer request serviced. This value 
includes the seek, rotational latency, and data transfer for the 
request. 
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sar -d 


device %busy avque r+w/s blks/s avwait § avserv 


08:00:08 dsk-0 1D 30 52 64.2 35,5 
dsk- 1 0 O71 1 4 0.0 28.0 
08:20:08 dsk-0 51 2.2 24 a2 63.1 34.9 
dsk- 1 0 0.0 0 0 0.0 0.0 
08:40:08 dsk-0 75 a 30 52 64.2 S555 
dsk- 1 0 0.0 0 0 0.0 0.0 
09:00:08 dsk-O 75 aus 30 52 64.2 3935 
dsk- 1 0 0.0 0 0 0.0 0.0 
Average dsk-0 15 oa) 30 a2 64.2 3945 
dsk- 1 0 0.0 0 1 0.0 7.0 


This sar output suggests a disk imbalance between the two 
available drives. It shows the first disk is doing virtually everything 
while the second disk is sitting idle. avserv values would decrease 
on a disk that had the proper software interleave set, and dcopy 
run for each of the file systems. The other values on the first drive 
would decrease if some of the load was shifted to the second 
drive. 


Another critical area reported by sar is swapping and switching 
activity. sar generates a report on these by executing the sar -w 
command. The critical columns are the swpot/s and pswch/s 
values. If the swpot/s value is greater than 1, you may need to 
increase memory on the system or decrease the number of 
buffers configured into the kernel. If the swpot/s are high at 
system startup, it is probably because of the loading of the swap 
area with sticky bit programs. pswch/s should be between 30 and 
100 on a busy 32-user system. If the value is greater than 100, it 
is necessary to examine the types of user processes running to 
see why the phenomenon occurs. 
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Sar -w 


swpin/s bswin/s swpot/s bswot/s_ pswch/s 


07:00:07 0.00 On 0.00 0.0 4 
08:00:07 0.07 i 2.08 1952 51 
09:00:07 azo figon re, | 22.8 32 
Average 0.43 3.4 1.43 14.0 29 


This output from sar suggests the system involved has high 
swapping activity and is a candidate for more memory to be 
added or for decreasing the number of buffers configured into the 
kernel. 


Related to the sar -w command is the sar -q command. It shows 
the run queue size, swap queue size, and the percentage of time 
the queues are occupied. rung-sz denotes the number of 
processes occupying the run queue. 


Each CPU looks for work on the run queue and the information for 
sar is in a common data structure accessible by all CPUs, so the 
percentage of time spent handling the queue appears large. 


sar -v reports on the size of various tables and the number of 
entries in those tables. The tables concern text, process, inode, 
and file entries. The sar output gives the ratio of the number of 
entries to the size of the table configured and the number of table 
overflows for each. If a table overflows, configure a kernel with a 
larger table to account for the number of overflows plus 10 
percent. This configuration accommodates some growth before 
you have to reconfigure another kernel. 


If CPU usage is high and the percentage of time spent in system 
mode (%sys) is the largest value, then the sar -c command can be 
useful. It can indicate where in the operating system the CPU is 
spending most of its time. The sar output can tell you if the CPU 
is processing many system calls and, more specifically, read, 
write, fork, and exec system calls. 
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Saf -C 
“™ scall/s sread/s swrit/s fork/s exec/s rchar/s wchar/s 
18:00:06 167 65 22 1.6 4.4 38302 28706 
19:00:06 203 81 23 bi 2 35824 20288 
20:00:06 210 89 27 144 A.f 53772 33408 
Average 193 78 24 1.8 4.8 42633 27467 


This sar output shows a normal activity for a busy 32 user system. 
To summarize, the key areas to look for are: 
- Blocked processes that are waiting for I/O 
- The balance of the disk activity 
c~ - Hit rate on buffer cache for both read and write operations 
- Swapping activity 


- CPU usage 


Disks are a Critical limiting factor of UNIX systems and the disks 
must share the work load whenever possible. If you have more 
than five processes blocked waiting for I/O, you may have to 
increase buffer space. If swapping activity is high, decreasing 
buffer space or adding more memory may be necessary. 


Unfortunately, tuning a system is an art. The ability to tune a 
system increases, however, every time that a system is tuned. 
Tools now exist that make the task less imposing than in the past. 
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Chapter 1. 
System Reconfiguration 


Introduction 


The 5000 Series operating system contains many _ internal 
Structures to keep track of processes, files, and system activity. 
The sizes of these structures can affect system performance. If 
the kernel structures are too large, they waste memory space 
which would otherwise be used for user processes or other kernel 
Structures. If the kernel structures are too small, they may cause 
excessive I/O, process aborts, or a system crash. 


Part of fine tuning a system is modifying the sizes of the kernel 


Structures to their optimal size. The sizes of the kernel structures 
may be changed by reconfiguring the system. 


NOTE: 


See tune_sys(iM) in the Administration Reference 


Manual for information on the tune_sys utility which 
may be used in reconfiguring parameters and 
rebuilding the kernel. 


Files/Programs Involved in Reconfiguring the System 


/etc/master A system file residing on every system 
Defines all possible devices drivers 


Defines the default configuration parameters 
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Must be modified to add an unsupported 
device driver 


cf file (or dfile) A user-created file with the name ver.cf 


residing in the directory /kernel/sperry/cf 
Defines the devices drivers on this system 


Defines the root, swap, pipe, and dump 
devices and the configuration parameters for 
this system 


Must be modified to add a new device, 
change configuration parameters, etc. 


Relink kernel A special make description file residing in the 


directory /kernel 


Creates a new kernel file which contains the 
device and configuration parameters defined 
in the cf file. 


Procedure to Reconfigure the System 


1-2 


Modify /etc/master to include an unsupported device driver. 
(If not adding an unsupported driver, skip this step). 


Modify or create a cf file to describe the system 
configuration and parameter values. 


Relink the kernel. 


Save the original /unix and rename the newly created kernel 
/unix. 


Test as necessary. 


Copy the new cf file to /sys/cf, to make the changes 
effective for reconfigurations using the sa menus. 
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/etc/master 


The /etc/master file defines all available devices and the default 
configuration parameters. This file contains three parts which are 
described in the following paragraphs. Each part is separated 
from the previous part by lines beginning with $. 


Device information 
This part defines all of the available device drivers. The 
information includes the internal device name, interrupt 
vector size, major device number, maximum number of 
devices per controller, etc. 


Device alias information 
This part defines alternate internal names for devices. 


Default configuration parameters 


This part defines the default values for the configuration 
parameters. 


NOTE: 


All configuration parameters which are not preset in 


the master file MUST be specified in the cf file. All 
other configuration parameters may be changed by 
specifying them in the cf file. 
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Partial Listing of etc/master 


* @(#)master 4.6 


mt 2 3 4 5 6 7mb 8mc 9 10 

nec 4 677 05 nec 4 0 0 2 6 tty 

wd 4 157715 wd 4 2 7 4 6 

ios 1 677 404 ios 4 0 3 8 7 tty iosinfo 
$S$ 

% 


* The following entries form the alias table. 


$$$ 


* 


* The following entries form the tunable parameter table. 
* 


buffers NBUF 
inodes NINODE 
files NF ILE 


See the Programming Reference Manual, master(4), for complete 
details. 


The cf File 
The cf file (or dfile) defines the following: 


- The devices (or drivers) on this particular system. For 
example: console driver, HPSIO driver, tape driver, Western 
Digital disk driver, etc. 


- The root device. This is the device where the root file system 
resides. 


- The swap device. This is the device for the swap area (when 
memory cannot hold all processes). 
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- The pipe device. This is the device where pipes (created with 
| symbol) are created. 


- The dump device. This is the device wnere memory dumps 
(after a crash) may be written. 


- The values of the configuration parameters. 


Partial Listing of a cf File 


hpm 0 0 0 
hp 700 T61200° -2 
nec 1534 172520 0 
wd 460 172220 1 
tp 3 0 T 
*at10 

root wd 04 

swap wd 74 1 8000 
pipe wd 04 

dump tp 0 

power 1 

buffers 40 


All cf files should be in the directory /kernel/sperry/cf. Each cf 
file must have a name in the form ver.cf, where ver is the version 
name for the new kernel. 


After installation or reconfiguration by means of the sa menus, the 
following is the cf file for the current configuration: 


/kernel/sperry/cf/5.2.cf 

After testing the new kernel, the cf file should be copied to the file 
/sys/cf. This file is used by the sa menus during reconfiguration. 
If the copy is not made, the next reconfiguration by means of the 


sa menus does not use the cf file you modified or created. 


The cf file has two parts: 
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- Physical Device Specification - Defines the device drivers on 
the system. 


- System Dependent Information - Defines the root, swap, 


pipe, and dump devices, and the values of the configuration 
parameters. 


Physical Device Specification 


device name | The name of the device driver, as specified 
in /etc/master. 


interrupt vector The interrupt vector location, specified in 
octal. 

device address The device address, specified in octal. 

bus request level The bus request level (4-7). 


number of devices The number of devices on the associated 
controller. 


System Dependent Information 

root device. minor 
The device name (name or alias in /etc/master) and the minor 
device number (specified in octal) for the root device. 


The valid device names are as follows: 


wd 5.25" disk 

sd External SCSI disk 
sd2 Internal SCSI disk 
sd3 Internal SCSI flex 


pipe device minor 
The device name and minor device number (in octal) for the 
device which will contain all pipes. 
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dump device minor 
The device name and minor device number (in octal) for the 
device where a system dump may be written after a crash. 


swap device minor swplo nswap 
The device name and minor device number (in octal) for the 
swap device. swplo is the first physical block (512-bytes) in 
the swap area, and nswap is the size of the swap area (in 
physical blocks). 


configuration parameters 
The values for configuration parameters follow the information 
specified previouslyr. See the configuration parameter 
descriptions in this chapter or in the Administration Reference 
Manual, config(1M), for more details. Each configuration 
parameter is specified as follows: 


name value 


Relinking the Kernel 


A special make file exists under the directory /kernel for relinking 
the (creating a new) kernel. This makefile creates the 
configuration table (which defines the device driver), and then 
relinks the kernel. 


Procedure 


cd /kernel 
make unix VER = ver REL = xxx NODE = Unisys SYS = UnixV 


where: 
ver is the version name for the kernel 
XXX is the release number for the kernel 


Unisys is the node name (displayed above login prompt) 
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UnixV is the name of the UNIX version 


The relink procedure must be able to locate a cf file with the 
name: 


/kernel/sperry/cf/ver.cf 
where ver is the version name for the kernel. 
The new kernel will have the following name: 


/kernel/sperry/unixver 


Example Reconfiguration of a Kernel 


1. Create a new cf file called /kernel/sperry/cf/test.cf 
2. Execute the following commands: 


cd /kernel 

make unix VER =test REL =3.01 NODE =5000 SYS = UnixV 
chmod 0744 /kernel/sperry/unixtest 

mv /unix /unix.old 

mv /kernel/sperry/unixtest /unix 

sync; sync 

/menu/obj/reboot.o device 


3. Test the new kernel. 
The following program performs a software reboot: 


/menu/obj/reboot.o device [pathname] 


device The hardware device name of the device 
containing the kernel. (See the "Formatting Disk 
Device" chapter of U 5000/20, U 5000/30, U 
5000/35, U 5000/40, U 5000/50, U 5000/55 
Systems; U 5000 Series Operating System; 
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Installation and Implementation Guide for a list of 
the root devices available for your system.) 


pathname The pathname of the kernel to load. If omitted, 
/unix is assumed. 


NOTE: 


This procedure must be performed while logged in as 


root. Be sure that no other users are on the system 
before rebooting, or enter single-user mode. 


Configuration Parameters 


The configuration parameters, specified in the cf file may be 
modified to fine tune a system. The rest of this chapter discusses 
the configuration parameters, and is divided into two sections: 


- Summary - An alphabetical summary of the configuration 
parameters, including their fixed or recommended ranges 
and default values. 


- Detailed Information - A_ detailed description of the 
configuration parameters also in alphabetical order. Each 
parameter description includes the following: 


Description 
A brief description of the configuration parameter and the 
kernel structure(s) it affects. This also includes the valid 
range, default value, and size of each parameter. 


When to Change 


Recommendations on when the parameter should be or 
may be changed. 
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Recommended Values 
Recommended values for the parameter. 


Potential Problems 
A brief description of the potential problems which may 
occur if the parameter is too small or too large. 


After studying the configuration parameter descriptions which 
follow, turn to Chapter 8 and perform Exercise 1: System 
Reconfiguration. 


Configuration Parameters Summary 


The tables on the following pages summarize the configuration 
parameters. For information on GPTF configuration parameters, 
see the "General Purpose Transaction Facility" section of this 
chapter. 


Table 1-1. Configuration Parameters Summary (Part 1 of 5) 


Parameter Default Description 
100- 1000t 256% buffers for block 1/0 
ial 4 al bi 
50- 650% the Timeout Table 
150- 3960F 660F buffers (cblocks) 
Kl ed Mia | socket 
used by GPTF 
Se eee 
needed by drivers for DMA 
Bice Mia la |= 
processor availability 
The number of entries in the 


System Open File Table 
* 5000/20/40 values only. 
+ 5000/30/35/50/55 values only. 
* New to 5000/30/35/50/55 Release 2.00. 
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Table 1-1. Configuration Parameters Summary (Part 2 of 5) 


Parameter Range Default Description 
The number of entries in 
the System V Lock Table 
laed tek al The % of a file system 
allocated before free 
space threshold exceeded 
ial al bd General Purpose Transaction 
hashbuf 32-128* 64* The number of entries in 
32- 256% 256% the Buffer Hash Table 
(must be a power of 2) 
Bac Bad Beall 5 
the Active Inode Table 
areas allocated for drivers 
The maximum number of 
he processes for a non-root user 
0x 100000 The maximum amount of 
Oxe00000F user address space 
( 1MB- 14MB ) 


minnonres#] 0 - maxmem 
8 
20% 


Facility (GPTF) feature. 
O= off, 1=o0n 


Message queue feature; 
O=unavailable, 1=available 


The minimum amount of 

memory that must be available 
for non-resident processes 
(GPTF ) 


Firmware monitor availability 
The number of entries in the 
the Mount Table 


* 5000/20/40 values only. 
+ 5000/30/35/50/55 values only. 
% New to 5000/30/35/50/55 Release 2.00. 
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Table 1-1. Configuration Parameters Summary (Part 3 of 5) 


Default 
100 


Parameter Range 


Description 


The number of entries 
in the Message Segment 
Map Table 


16384 The maximum number of 
bytes per message queue 


50 The maximum number of 


message queues on 
the system 


1024 The number of message 
segments on the system 
The size of a message segment 


4O The maximum number 


of outstanding messages 


msgtql 2-256 
(message headers) 

nf locks 10- 1000 200 The maximum number of locked 
regions in files 


nocheck® 0-1 GPTF capability that permits 


no parameter checking 
cael 


for system calls 
The number of GPTF 
timers on the system 
physbuf 
Book 


raw (1/0) buffer headers 
attempted or not attempted 
* 5000/20/40 values only. 


The number of entries 
in the Process Table 

+ 5000/30/35/50/55 values only. 

% New to 5000/30/35/50/55 Release 2.00. 


16- 4096 


soni 
_ 
=) 
=) 


0 
3 


aes 
=f 
0-1 


20 
4 
1 

65" 
70% 
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Table 1-1. Configuration Parameters Summary (Part 4 of 5) 


Default Description 


| 
O=unavailable, 1=available 
on-exit value 

10 The number of entries in 

the Semaphore Map Table 


Parameter Range 


2- 1024 


1- 256 10 The maximum number of 
lat bal ee semaphore sets in the system 
semaphores in the system 
Ka aie Bl 
semaphores in the system 
Bal Ci Nad eh 
structures in the system 


The maximum number of 
semaphores per set 


0 
25 
10 The maximum number of 


semaphore operations per 
semop system call 


10 The maximum number of 
undo entries per structure 


32767 The maximum value 
of a semaphore 


1-256 256 


shmbrk 0- 480* 
0- 960K* 


* 5000/20/40 values only. 
+ 5000/30/35/50/55 values only. 
% New to 5000/30/35/50/55 Release 2.00. 


The maximum number of 
clicks for shared memory 
segments 


16” 
32K* 


The gap between the end 
of the data segment and the 
beginning of the first 
shared memory segment 
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Table 1-1. Configuration Parameters Summary (Part 5 of 5) 


Parameter Range Default Description 


shmem 0-1 1 Shared memory feature; 
O=unavailable, 1=available 


shmmax 0x800 - 4 x 0x8000 | The maximum size 
(in bytes) of a shared 
memory segment 


4 x 0x8000 


The minimum size 
(in bytes) of a shared 
memory segment 


The maximum number of 


shared memory segments in 
the system 

ions eae The maximum number of 
attached shared memory 
segments per process 

al ial 
kernel specification 

The number of entries in 
the Swap Map Table 

Swap expand feature (swap 


space allocated when 
texts 20- 50* 
20- 100% 


memory is allocated) 
The number of entries 
in the Text Table 

* 5000/20/40 values only. 


The CPU time slice 
(in hundredths of a second) 
+ 5000/30/35/50/55 values only. 


* New to 5000/30/35/50/55 Release 2.00. 
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buffers 


Description 


The buffers parameter specifies the number of system buffers for 
block I/O. The system buffers are used to cache blocks from the 
disk (any block read from or written to the disk is placed in a 
system buffer). Frequently used blocks stay in a buffer (in 
memory) and writes of partial blocks occur in the buffer in 
memory. This helps the system avoid time consuming physical I/O 
for disk access. 


Range: 5000/20/40: 40-400 
5000/30/35/50/55: 100-512 


Default: | 5000/20/40: 40 
5000/30/35/50/55: 256 


Size: 1080 bytes per buffer (includes buffer and buffer 
header) 


When to Change 


In general, the more buffers, the better the performance. Some 
types of applications, such as database programs, benefit more 
from an increase in buffers than utilities which process files 
sequentially. A change in the number of buffers is made to try to 
improve performance. Note, however, the potential problems 
listed later in this section. 


Recommended Values 


There is no definite way to tell exactly how many buffers are best 
for a particular system. The ideal number of buffers depends 
upon many factors — memory size, hardware configuration, 
software packages, and processes running. 


The optimum number of buffers for each system configuration 
should be generated by means of tests in the user environment. 
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| 
| 
The following chart gives some estimated ranges for various 
configurations and software packages being used. This chart may 
be used to help determine the number of buffers to configure. 


Remember, each additional buffer takes up 1080 bytes of kernel ad 
memory space. 


Est. Range Est. Range 


Configuration #1 plus 8" disk 
Configuration #3 plus NET 


Configuration #3 plus MPCA 
Configuration #6 plus HDLC, 256 
RBS, or 3270 BSC 
The default value of 256 buffers for 5000/30/35/50/55 systems 


should be adequate for most configurations. This value may be WwW | 
modified. | 


Potential Problems 


Buffers consume a large amount of memory: 1024 bytes for each 
buffer and 56 bytes for a buffer header to keep track of each 
buffer. If too many buffers are allocated, there may not be 
enough physical memory for user processes, and the amount of 
swapping and paging may increase. The swapping activity usually 
costs more in system efficiency than what is saved by having a 
large number of buffers. | | 


If the number of buffers specified in the configuration parameters 
is too large for the other kernel structures and drivers, unusual | 
problems can occur. One symptom is the system will not boot | 
(usually stops after displaying the banner messages, possibly with SS 
a panic: binit message). Another symptom is a driver which 
dynamically allocates buffer space (such as the tape driver) no | 
longer works. If any unexplained errors occur after an increase in | 
the number of buffers, decrease the number of buffers. These 
unusual problems are the result of requiring more than the | 


| 
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maximum logical address space for the kernel. See Chapter 2 for 
more information on kernel logical address space. 
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calls 


Description 


The calls parameter specifies the number of entries in the Call-Out 
(Timeout) Table. The Call-Out Table is used by device drivers to 
provide a timeout to make sure that the system does not hang 
when a device does not respond to commands. 


Range: 5000/20/40: 50 - 350 
5000/30/35/50/55: 50 - 650 


Default: 100 


Size: 12 bytes per entry in the Call-Out Table 


When to Change 

The calls parameter should only be changed if more than 2 HPSIO o 
boards are added to the system or if a new device driver which 

performs many timed actions is added to the system. 


Communication drivers normally perform more timed activity than 
other drivers. 


Recommended Values 


The calls parameter should be increased by 50 for each HPSIO 
board which is added. 


NOTE: 


An HPSIO-16 controller counts as two in this usage. 
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Potential Problems 


If the calls parameter is too small, the system crashes and the 
error message panic: timeout table overflow appears. 
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clists 


Description 


The clists parameter specifies the number of character list buffers 
(cblocks). The character list buffers are used as a temporary 
holding area for terminal I/O, so that characters entered from a 
terminal are not lost and also to allow character preprocessing. 
These character list buffers are also used for other terminal type 
devices (e.g., printers). 


Range: 5000/20/40: 150-960 
5000/30/35/50/55: 150-3960 


Default: | 5000/20/40: 150 
5000/30/35/50/55: 660 


Size: 70 bytes per character buffer 


When to Change 


The amount of activity in the TTY subsystem determines the size 
of the clists parameter. Since the character buffers are used for 
input and output over the TTY lines, performance is the primary 
reason for increasing the clists parameter. The parameter should 
be increased if the TTY subsystem is slow on output or if input 
characters are lost. 


Recommended Values 


The following formula, based on the number of terminals and baud 
rate of each terminal, should be used to compute the clists 
parameter value. If terminals run at different baud rates, the size 
of the clists parameter should be the sum of the results from the 
formula for each baud rate. 


(( (baud rate / 10) * 2) * # of terminals at this baud ) / 64 
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The preceding formula allows enough character buffers for a 2- 
second backlog of data at all terminals in the system. If a system 
has low terminal activity, this value may be reduced by one-half. If 
a system has high terminal activity, this value should be adequate. 


Devices which send large amounts of data INTO a system may 
require a further increase in the size of the clists parameter. 


Potential Problems 


If the number of character buffers is too small, the output to TTY 
devices is slow and input characters may be lost (not even echoed 
back to the terminal). Increase the size of the clists parameter if 
this occurs. 
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dkpri 


Description 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


The dkpri parameter specifies the type of sorting for disk I/O 
requests. Disk I/O requests are always sorted by seek distance, 
with the dkpri parameter providing sorting by process priority as 
well. 

Range: 0 - 127 

Default: 0 


Size: 0 


When to Change 


If the GPTF features are used, set the dkpri paramter to 1 so that 
disk I/O requests by real-time processes are handled before disk 
I/O requests by time-shared processes. This improves the 
performance of the real-time processes. 


NOTE: 


Changing this parameter has no effect if the gptf 
parameter is not set to 1. 
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Recommended Values 


A value of O for the dkpri parameter sorts disk I/O requests by 
seek distance only. 


If GPTF is activated (gptf parameter set to 1), the reommended 
value for dkpri is 1. This sorts disk I/O requests into the following 
3 categories and then sorts each category by seek distance: 

- kernel (system) processes 

- real-time processes 


- time-shared processes 


A value of 127 for the dkpri parameter sorts disk I/O requests by 
process priority only. This value is NOT recommended. 


If you assign dkpri a value other than O, 1, or 127, the value 
determines the number of groups within which each request is 
sorted according to seek distance. For example, if you assign 
dkpri the value 8, eight indexes are defined for the sort table. 
Within each of the eight groups, requests are sorted by seek 
distance. 


Potential Problems 


The dkpri parameter is modified to try to improve the performance 
of real-time processes when the GPTF feature is activated. 


If the dkpri parameter is set to 127, disk I/O requests are not 
sorted by seek distance. This decreases overall disk throughput. 
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dmanpb 


Description 
The dmanpb parameter specifies the total number of page blocks 
required for all drivers to perform Direct Memory Access (DMA). 
These page blocks are logical address space for the kernel, and do 
not require physical memory. 

Range: Variable 


Default: 8 


Size: 0 (does not increase physical kernel size) 


When to Change 


The dmanpb parameter is ignored by the 5000 Series system, and 
is included for compatability with older releases. 


The system automatically allocates 2 page blocks for each driver 
which sets the "need DMA resources" bit in /etc/master. This 


allocation is of logical address space ONLY, and does not require 
any physical memory. See Chapter 2 for more information. 


Recommended Values 


The dmanpb parameter does not need to be changed by a user 
since it is ignored by the system. 


Potential Problems 


None since this parameter is ignored. 
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ffpflag 


Description 


The ffpflag parameter specifies the inclusion of the SKY Floating 
Point Processor routines. This feature is unsupported. 


Range: 5000/20/40: 0 - 1 
5000/30/35/50/55: Not applicable 


Default: 5000/20/40: 0 
5000/30/35/50/55: Not applicable 


Size: O (does not increase kernel size) 


When to Change 

If the use of the SKY floating point processor is required, the 
ffpflag parameter specification must be added to BOTH the 
/etc/master file and the cf file. 


The use of the SKY floating point processor and the associated 
routines is unsupported. 


Recommended Values 
The ffpflag parameter should be set to 1 in BOTH the /etc/master 


file and the cf file to permit the use of the routines for the SKY 
floating point processor. 


Potential Problems 


If the ffpflag parameter is not set, the SKY floating point routines 
cannot be used. 
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files 


Description 

The files parameter specifies the number of entries in the System 
Open File Table. Each entry represents an open file (one entry per 
open system call). When a process is created, its open files are 
the same as its parent’s, so it does not use any additional entries 
in the System Open File Table until it specifically opens a file. 
Range: 100 - 500 

Default: 175 


Size: 12 bytes per entry in the System Open File Table 


When to Change 


The files parameter should be increased if the total number of 
open files in the system exceeds the current setting. The number 
of entries required in the System Open File Table depends upon 
the number of files that independent processes open. 


NOTE: 


The maximum number of open files per process is a 


fixed value: 64 per process (the maximum was 20 for 
Release 2.00 or earlier). The files parameter does NOT 
affect this pre-process limit. 
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Recommended Values 


If a system exceeds the limit of this parameter, the system 
administrator should evaluate the number of users running at the 
time the value was exceeded and compare that to the number of 
users at maximum load. The files parameter should be increased 
accordingly. 


NOTE: 


All processes have 3 open files: STDIN, STDOUT, and 


STDERR. The number of additional open files required 
depends upon the application. 


Potential Problems 
If the files parameter is too small, file opens fail with the error 


ENFILE: file table overflow and a message no file is displayed 
upon the console for each failed open. 


NOTE: 


If a process has exceeded the per-process limit of 64 


open files, additional file opens fail with the error 
EMFILE: too many open files and no message is 
displayed on the console. 
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fickrec 


Description 


The fickrec parameter specifies the number of entries in the Lock 
Table when the System V Interface Definition (SVID) lockf library 
function is used. One Lock Table entry is required for each region 
of a file that is locked. If the entire file is locked, only 1 Lock Table 
entry is required. If 3 records in a file are locked, 3 Lock Table 
entries are required. 


To use the SVID lockf library function, specify -llockf on the Id or 
cc command line. 


Range: 20/40: Not applicable 
30/35/50/55: 10 - 1000 


Default: 20/40: Not applicable 
30/35/50/55: 200 


Size: 20/40: Not applicable 
30/35/50/55: 28 


When to Change 


The flckrec parameter should only be changed if the SVID lockf 
system call is used. It should be increased if the number of 
regions of files to be locked exceeds or is approaching the current 
value. The flckrec parameter may be decreased if record locking 
is not used. If a system uses record locking for an extremely large 
file or for many files, the flckrec parameter may need to be 
increased. Releases before this did not have the SVID lockf library 
function. 


Recommended Values 


The flckrec parameter should be changed according to the 
maximum number of records locked at any one time on the 
system. 
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Potential Problems — 


If the flckrec parameter is too small, the lockf system call returns 
the error ENLOCK: Lock table overflow. 
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fsthresh 


Description 

The fsthresh parameter specifies the percent of a file system that 
is to be allocated before signifying that the free space threshold 
has been reached. The free space threshold generates an error 
log record and displays the following message on the console: 

File System Threshold Reached on Device major# minor# 
Range: O - 100 

Default: 90 


Size: 0 


When to Change 


If you want the free space threshold message generated earlier or 
later than the default value (90% full), change the fsthresh 
parameter. 


Recommended Values 


The fsthresh parameter may be changed without any 
performance decrease, or any increase in kernel size. Remeber 
that the default value of 90 means that 90% of the file system 
Space must be allocated before the free space threshold is 
reached. 


Potential Problems 
If the fsthresh parameter is 100, then the free space threshold is 


not reached until the file system is full. If the fsthresh parameter 
is 0, then the free space threshold is reached immediately. 
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gptt 


Description 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


The gptf parameter specifies that the General Purpose Transaction 
Facility (GPTF) should be activated. GPTF provides real-time 
features along with the normal time-sharing features of the 
operating system. The features include the following: 

- fixed priorities (real-time and shared-time levels) 


- reduced CPU latency for real-time process 


- message event handling using shared memory and 
semaphores 


- timers with 16.67 millisecond resolution 


Range: 0-1 
Default: 1 
Size: 8K 


When to Change 


Modify the gptf parameter to activate or deactivate the GPTF 
feature. 


Recommended Values 
Set the gptf parameter to 1 to activate the GPTF feature. 


Set the gptf parameter to 0 to deactivate the GPTF feature. 
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Potential Problems 


If the gptf parameter is 0, execution of the utilities tpset, 
tpaccess, and tps result in the error Illegal instruction - core Ww 
dumped. 


If the gptf parameter is 0, a program that uses the system calls 
tpfix, tpprio, tpset, tptimalloc, tptimdealloc, tptimset, tptimreset, 
tptimdisable, and tptimenable compiles without error, but returns 
the following error when executed: Illegal instruction - core 
dumped. 


NOTE: 


The shmem and sema parameters must be set to use 
the following GPTF system calls: smsinit, smslock, 
smsunlock, smq_init, smq_get, and smq_put. 
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hashbuf 


Description 


The hashbuf parameter specifies the number of entries in the 
Buffer Hash Table. Each entry in this table is the head of a queue 
of buffer headers. A hashing algorithm using the device and block 
number determines the entry in the Buffer Hash Table to search 
when a buffer in the System Buffer Area is requested. This allows 
fewer buffers per queue, which reduces the search time. 


Range: 5000/20/40: 32 - 128 
5000/30/35/50/55: 32 - 256 


Default: | 5000/20/40: 64 
5000/30/35/50/55: 256 


Size: 12 bytes per entry in the Buffer Hash Table 


When to Change 


If the number of buffers in the System Buffer Area (the buffers 
parameter) changes, the value of the hashbuf parameter should 
be evaluated. 


Recommended Values 


The value of the hashbuf parameter MUST be a power of 2 (382, 
64, 128, 256). The value of hashbuf should be the closest value to 
the number of buffers (the buffers parameter) as possible. The 
following chart may be used to help determine the size of the 
hashbuf parameter. 
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buffers | hashbuf 


WwW 
Potential Problems 
If the hashbuf parameter is too small, the system buffer efficiency 
is reduced. Make sure that the value of hashbuf is close to the 
value of buffers so that the full efficiency of the buffers is 
achieved. 

WOW 
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inodes 


Description 

The inodes parameter specifies the number of entries in the Active 
Inode Table. Each entry represents an active inode (file) in the 
system. An inode is active if it is being used by a process in any 
way (as an open file, current directory, root directory of a file 
system, shared text file, etc.) 

Range: 100 - 500 

Default: 175 


Size: 96 bytes per entry in the Active Inode Table 


When to Change 
The inodes parameter should be increased if the total number of 
active inodes in the system exceeds the current setting. An inode 
requires an entry in the Acitve Inode Table if if is being used in any 
of the following ways: 

- open file 

- special files for defined terminals 

- files currently being executed 

- files which executed with the sticky bit set 

- current directories for processes 


- root directories of all mounted file systems (including root) 


- mount points for all mounted file systems (the directory 
where the file system is mounted. 
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- pipes 
- files being linked to or removed 
Sd 
- directories being used in pathname searches 
NOTE: 
Increasing the number of processes on the system 
(the procs parameter), the number of shared text files 
(the texts parameter), or the number of mounted file 
systems (the mounts parameter), may require the 
inodes parameter to be increased. 
Recommended Values | 
Ww 
If a system exceeds the limit of this parameter, the system 
administrator should evaluate the number of users running at the 
time the value was exceeded and compare that to the number of 
users at maximum load. The inodes parameter should be 
increased accordingly. 
Potential Problems 
If the inodes parameter is too small, an open, exec, or mount 
system call fails and the message, Inode table overflow is 
displayed on the console for each failed system call. 
WJ | 
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kins 


Description 


The kins parameter specifies the number of 64K addressable 
regions in the kernel needed to support system device drivers. 
The 64K area is a logical address space requirement only - it does 
not take physical memory. See Chapter 2 for more information 
about the logical address space of the kernel. 


Range: O- 1 
Default: 1 
Size: 4 bytes per 64K addressable region (physical space) 


64K logical address space 


When to Change 


The 64K addressable regions in the kernel are currently only 
needed by the MPCA driver. 


The kins parameter should be decreased to 0 if the MPCA driver is 
not included in the kernel (to save 64K of logical address space). 


The kins parameter may need to be increased if a new device 


driver which requires a 64K addressable region is added to the 
system. 


Recommended Values 

The kins parameter should be decreased to 0 if the MPCA driver 
(or any other driver requiring this region) is not included in the 
kernel. 

The kins parameter should be increased by 1 for each 64K 


addressable region which is required by a driver. 
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Potential Problems 


If the kins parameter is too small, the device driver which requires | 
the 64K addressable region does not work correctly. The error Ww 
message displayed depends upon the driver. 
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maxproc 


Description 


The maxproc parameter specifies the maximum number of entries 
in the Process Table per user ID. Each entry represents an active 
process on the system (the ps command displays the Process 
Table). 


NOTE: 


This limit is per user ID, not per terminal. The 
superuser is not restricted by this parameter. 


Range: Value of procs parameter 


Default: 5000/20/40: 25 
5000/30/35/50/55: 35 


Size: 0 (does not increase kernel size) 


When to Change 

If the system administrator wants to restrict the number of 
processes each user ID may create, the maxproc parameter 
should be decreased. 


If the same user ID is used by more than one user, then the 
maxproc parameter may need to be increased. 


Recommended Values 
This parameter may be changed without any performance 


decrease or increase in kernel size. In general, approximately 10 
processes per active User ID should be adequate. 
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Potential Problems 


If the maxproc parameter is too small, users who try to create 
more than this number of processes receive the system error 
EAGAIN: No more processes. The shell returns the following 
error message for the same problem: fork failed: too many 
processes. 
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maxspace 


Description 


The maxspace parameter specifies the maximum address space 
for a user program. This parameter is available for the 
5000/30/35/50/55 only; the maximum user address space on a 
5000/20/40 is 1MB. 


Range: 5000/20/40: Not available 
5000/30/50 releases other than 2.00: 1048576 - 
14680064 (1MB - 14MB) 
5000/30/35/50/55 Release 2.00 only: 0x100000 - 
oxe00000 (1MB - 14MB) 


Default: .5000/20/40: Not available 
5000/30/50 releases other than 2.00: 1048576 (1MB) 
5000/30/35/50/55 Release 2.00 only: 0x100000 


Size: 0 (does not increase kernel size) 


When to Change 


If user programs are larger than 1MB, this parameter needs to be 
increased, 


Recommended Values 


The value of maxspace should be the minimum possible to handle 
the largest user program. This parameter should be increased in 
multiples of 1MB. 


Potential Problems 


The swap space for the system must be at least large enough to 
hold the largest program executed, even if no swapping occurs. 
The default size of swap space on the 5000/30/35/50/55 is 10MB. 
If the maxspace parameter is larger than 10MB, then the swap 


UP-12715 R1 1-41 


Chapter 1 


space for the system must be increased. See Chapter 2, "Use of 
Memory," for information on how to change the size of the swap 
space. 
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mesg 


Description 


The mesg parameter specifies the inclusion of the routines for 
handling message queues. Processes may utilize message queues 
to send messages to or receive messages from other processes 
by using the msgget, msgctl, msgsnd, and msgrcv system calls. 


Range: O-1 
Default: 1 
Size: 0 (does not increase kernel size) 


Although this parameter does not increase the kernel size, it does 
cause the related parameters (the parameters with names 
beginning with msg to become effective. These related 
parameters can increase the kernel size. 


When to Change 


The mesg parameter should be set to 1 if processes need to use 
message queues. 


NOTE: 


Message queues remain on the system until they are 
specifically removed. The system administrator should 


use the ipcs command to check for existing 
semaphore sets which are not currently in use, and 
remove them with the iperm command. 
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Recommended Values 
The mesg parameter should be set to 1 to permit the use of 


message queues. Since this can increase the size of the kernel, 
mesg should only be set if message queues are actually used. 


Potential Problems 
If the mesg parameter is not set: 


1. A msgget, msgctl, msgsnd, or msgrcv system call returns 
the error Bad system call - core dumped. 


2. The ipes command displays Message Queue facility not in 
system. 
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minnonres 


Description 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


The minnonres parameter specifies the minimum amount of 
memory (in 2K clicks) that MUST be available for non-resident 
processes. This prevents resident processes from using all 
available memory. 


Resident processes are created using GPTF features. 


NOTE: 


Resident processes cannot be swapped or paged out 
of memory. 


Range: O - x, where x is equal to the amount of physical 
memory in 2K clicks 


Default: 100 

Size: 0 

When to Change 

If resident processes are reserving too much memory (so that 


normal processes cannot run or are continually swapping), 
increase the minnonres parameter. 
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NOTE: 


Changing this parameter has no effect if the gptf 
parameter is not set to 1. 


Recommended Values 


The default value of 100 reserves 200K of memory for non-resident 
processes. This should be considered as a minimum so that 
normal processes can execute. 


Increase the value of the minnonres parameter if swapping or 
paging activity for normal processes has increased because of 
excessive memory use by resident processes. 


Potential Problems 


If a normal process is created after the maximum is reached, 
swapping and/or paging activity begins. This affects the 
performance of both the non-resident processes and the entire 
system. 


If a resident process is created that would exceed the maximum 


amount of memory for resident processes, the fork returns the 
error ENOMEM: not enough space. 
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monfig 


Description 


The monflg parameter specifies whether the firmware on the 
system contains a monitor. This flag stops the kernel from 
claiming the exception vector associated with a trap 14 instruction, 
used for setting break points. 


This feature is not required in the field. The firmware monitor is 
only included for in-plant testing. 


Range: O- 1 
Default: 0 
Size: O (does not increase kernel size) 


When to Change 


The monflg parameter is for internal (in-plant) use only, and 
should never be changed. 


Recommended Values 


The monflg parameter should be set to 1 if the firmware monitor is 
included in a system. 


Potential Problems 


If the monflg parameter is not set, and the system includes the 
firmware monitor, the the monitor would not be able to be used. 
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mounts 


Description 


The mounts parameter specifies the number of entries in the 
Mount Table. Each entry represents a mounted file system. 


The root file system always uses the first entry in the Mount Table. 
Range: 8 - 50 


Default: Prior to Release 2.00: 8 
Release 2.00 only: 20 


Size: 18 bytes per entry in the Mount Table 


When to Change 

The mounts parameter should be increased if the number of file 
systems which must be mounted is greater than 7 (remember, the 
first entry is always used for the root file system). 


If a system uses the partitioning of disks, the mounts parameter 
may need to be increased to permit the mounting of all partitions. 


Recommended Values 


The mounts parameter should be increased by 1 for each 
additional file system which needs to be mounted. 


Potential Problems 


If the mounts parameter is too small, a mount system call returns 
the error EBUSY: mount device busy. 
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msgmap 


Description 


The msgmap parameter specifies the number of entries in the 
Message Map Table. Each entry in the Message Map Table 
represents a free area in the message buffer area. Messages 
must be contained in a contiguous area in the message buffer 
area. Space is allocated in message segments. 


Range: 2- 1024 
Default: 100 


Size: 4 bytes per entry in the Message Map Table 


When to Change 


The msgmap parameter may be modified if the maximum number 
of message segments on the system (the msgseg parameter) is 
modified. 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The default value for the msgmap parameter should be adequate 
for most applications of messages. The value of the msgmap 
parameter depends upon the number of message queues, the 
number of messages per queue, and the sending/receiving of 
messages. More entries in this table are required if the free areas 
in the message buffer area become fragmented into small groups 
by the sending/receiving of messages. 
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Potential Problems 


If the msgmap parameter is too small, the system "loses" free 
areas in the message buffer area when a msgrcv system call 
receives a message. These "lost" areas cannot be allocated to 
another message on a subsequent msgsnd system call. 
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msgmax 


Description 


The msgmax parameter specifies the maximum size of a message 
(in bytes). 


Range: 8- 16384 
Default: 8192 


Size: O (does not increase kernel size) 


When to Change 

The msgmax parameter may be increased if the maximum size of 
a message needs to be increased. It may be decreased if the 
system administrator wants to limit the size of messages. 


Changing this parameter. has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The msgmax parameter should be large enough for the largest 
message which needs to be in a message queue. 


The msgmax parameter may be decreased to prevent a few large 


messages from taking all the memory space reserved for message 
queues. 


Potential Problems 
If the msgmax parameter is too small, a msgsnd system call 


which attempts to send a message larger than the value returns 
the error EINVAL: Invalid argument. 


UP-12715 R1 1-51 


Chapter 1 


msgmnb 


Description 


The msgmnb parameter specifies the maximum number of bytes 
per message queue. 


Range: 8 - 32768 
Default: 16384 


Size: O (does not increase kernel size) 


When to Change 


The msgmnb parameter may be increased if the maximum 
number of bytes on a message queue needs to be increased. It 
may be decreased if the system administrator wants to limit the 
number of bytes per message queue. 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The msgmnb parameter should be at least large enough to hold 
the largest message which may be on a queue (the msgmax 
parameter). 


If this value is modified, the msgseg parameter, which specifies 
the number of message segments for the system, may also need 
to be modified to ensure that enough memory is reserved to hold 
the messages. 
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Potential Problems 


If the msgmnb parameter is too small, a msgsnd system call 
which attempts to send a message which would put the number of 
bytes on a message queue over the maximum waits until 
messages are read (received) from the queue. 
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msgmni 


Description 

The msgmni parameter specifies the maximum number of 
message queues permitted on the system. Each message queue 
may contain many messages. 

Range: 1- 100 

Default: 50 


Size: 54 bytes per message queue 


When to Change 


The msgmni parameter may be modified if the system 
administrator wants to permit more message queues on the 
system. 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The msgmni parameter should be increased if the number of 
message queues required on the system is greater than the 
current limit. Remember that this takes up more kernel memory 
space. 


Potential Problems 
If the msgmni parameter is too small, a msgget system call which 


attempts to create a new message queue returns the error 
ENOSPC: No space left on device. 
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msgseg 


Description 

The msgseg parameter specifies the number of message 
segments in the system. Each message on a message queue 
consists of one or more message segments (the size of each 
segment is specified in the msgssz parameter). This parameter 
determines the total number of bytes in memory reserved for 
messages. 

Range: 16 - 4096 

Default: 1024 


Size: msgssz * msgseg bytes reserved for messages 


The msgssz parameter determines the size of a message 
segment. 


When to Change 


The msgseg parameter may be increased if all the messages 
which need to be sent do not fit in the reserved memory space. 


The msgseg parameter may be decreased to reduce the amount 
of memory reserved for messages (if kernel size is a potential 
problem). 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The msgseg parameter may be increased so that the system 
administrator can reserve more memory space for messages. 
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The messeg parameter may be decreased so that the system 
administrator may minimize the amount of kernel memory which is 
reserved for messages. 


Potential Problems 


If the msgseg parameter is too small, all messages which need to 
be sent will not fit in the reserved message buffer space. 
Processes executing a msgsnd system call which would exceed 
the reserved space wait until space is available (messages must be 
received from message queues). 


If the msgseg parameter is too large, kernel memory may be 
wasted (reserved for messages but never used). 
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msgssz 


Description 
The msgssz parameter specifies the size of a message segment. 
Each message consists of a set of contiguous message segments 
large enough to hold the text of the message. The segments are 
used to help eliminate fragmentation and speed the allocation of 
message buffers. One message may span several message 
segments. 

Range: 8- 1024 

Default: 8 


Size: msgssz bytes per message segment 


The msgseg parameter determines the number of message 
segments allocated. 


When to Change 


The msgssz parameter may be increased if the messages are all 
of a standard (larger) size. 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 
The default value for the msgssz parameter is set to minimize 


wasted message buffer space. If messages are all the same 
length (for this system), this value may be set to that size. 


Potential Problems 


If the msgssz parameter is too large, message buffer space may 
be wasted due to fragmentation. This may cause processes 
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sending messages to sleep waiting for message buffer space, 
which slows down their performance. 
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msgtql 


Description 


The msgtql parameter specifies the number of system message 
headers. One message header is required per outstanding 
(unread) message. Therefore, this parameter limits the number of 
outstanding messages. 


Range: 2- 256 
Default: 40 


Size: 12 bytes per message header 


When to Change 


The msgtql parameter may be increased if the maximum number 
of outstanding messages on a message queue needs to be 
increased. It may be decreased if the system administrator wants 
to limit the number of outstanding messages. 


Changing this parameter has no effect if the mesg parameter is 
not set to 1. 


Recommended Values 


The msgtql parameter should be large enough to permit 
processes to send required messages. The number of required 
outstanding messages depends upon the coordination between 
processes sending and receiving messages. If processes send 
many messages before a process receives the messages, the 
msgtql parameter may need to be increased. 


Potential Problems 


If the msgtql parameter is too small, a msgsnd system call which 
attempts to send a message which would put the number 
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outstanding messages over the maximum waits until messages are 
read (received) from queues. 
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nflocks 


Description 


The nflocks parameter specifies the number of locklist entries. 
One locklist entry is required for each region of a file which is 
locked. If the entire file is locked, only one locklist entry is 
required. If three records in a file are locked, three locklist entries 
are required. 


Range: 10 - 1000 
Default: 200 


Size: 20 bytes per locklist entry 


When to Change 


The nflocks parameter should be increased if the number of 
regions of files to be locked exceeds or is approaching the current 
value. The nflocks parameter may be decreased if record locking 
is not used. If a system uses record locking for an extremely large 
file or for many files, the nflocks parameter may need to be 
increased. 


Recommended Values 
The nflocks parameter should be changed according to the 


maximum number of records locked at any one time on the 
system. 


Potential Problems 


If the nflocks parameter is too small, the locking system call 
returns the error EDEADLOCK. 
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nocheck 


Description 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


The nocheck parameter provides the capability for GPTF system 
calls to be performed WITHOUT parameter checking. This is 
provided for faster execution of fully debugged real-time 
programs. 


CAUTION: 


If no parameter checking is performed, system calls 


can potentially access illegal areas of memory, causing 
system problems. Only use this feature with fully 
debugged programs. 


Range: O-1 
Default: 0 
Size: 0 


When to Change 


Set the nocheck parameter to 1 to provide the fastest possible 
performance for real-time programs after they are fully debugged. 
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NOTE: 


Changing this parameter has no effect if the gptf 
parameter is not set to 1. 


Recommended Values 
The nocheck parameter should be set to 0 for most situations. 


Only set this parameter to 1 if absolutely necessary (if the 
performance of real-time processes MUST be as fast as possible). 


Potential Problems 
If a GPTF system call is performed with no parameter checking, 


and an error is made, kernel memory can be corrupted. This may 
result in the system halting ("panic"). 
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ntimers 


Description 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


The ntimers parameter specifies the number of GPTF timer 
structures available on the system. That is, the number of timers 
that may be allocated. GPTF timers may be allocated, set, and 
manipulated using the system calls tptimalloc, tptimdealloc, 
tptimset, tptimreset, tptimdisable, and tptimenable. 

Range: 0Q-50 

Default: 20 


Size: 50 


When to Change 


Increase the ntimers parameter to permit processes to allocate 
more GPTF timers. 


Decrease the ntimers parameter to decrease the amount of 
memory reserved for GPTF timers. 


NOTE: 


Changing this parameter has no effect if the gptf 
parameter is not set to 1. 
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Recommended Values 
The default value (20) of the ntimers parameter should be 


adequate for most situations. Increase or decrease the value as 
necessary. 


Potential Problems 
If the ntimers parameter is too small, a process trying to allocate a 


GPTF timer structure returns the error ENOMEM: not enough 
space. 
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physbuf 


Description 


The physbuf parameter specifies the number of physical (raw) I/O 
buffer headers. One physical I/O buffer header is required by a 
driver for each active physical read or write (I/O to the "raw" 
device). This is specified by using the "raw" device (character 
special file for a disk) and requesting specific blocks. 


NOTE: 


The drivers in the 5000 Series operating system do not 


use this method for physical I/O. Therefore, this 
parameter has. no effect for the 5000 Series system. 


Range: 3-7 
Default: 4 
Size: 56 bytes per physical I/O buffer header 


When to Change 

The physbuf parameter is not used by the disk drivers on the 5000 
Series system. This parameter does not normally need to be 
changed. 

If an unsupported driver is added to the system which uses this 


method for physical I/O, then the physbuf parameter may be 
modified if many physical I/O operations occur concurrently. 


Recommended Values 


The physbuf parameter should not need to be changed since it is 
not used by 5000 Series drivers. 
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However, if an unsupported driver is added which uses this 
method for physical I/O, the value of physbuf should be equal to 
the number of concurrent physical I/O operations desired. 


Potential Problems 
None for normal use. 


If an unsupported driver is added to the system using this method, 
and the physbuf parameter is too small, a process trying to 
perform physical I/O sleeps until a physical I/O buffer header is 
available. Therefore, this parameter does not cause failure of a 
process or the system. 
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power 


Description 


The power parameter specifies whether the system attempts to 
restart after a power failure. 


Range: O-1 
Default: 1 
Size: 0 (does not increase kernel size) 


The default value of O (no power-fail recovery) is specified in 
/etc/master to be compatible with AT&T. The value specified in 
the config.cf file always changes the value to 1 (power-fail 
recovery attempted). 


When to Change 


The power parameter should never be changed. 


Recommended Values 

The power parameter should be 1 to specify that power-fail 
recovery should be attempted. It may be changed to 0 if power- 
fail recovery is not desired. 


This parameter should always be 1. 


Potential Problems 
If the power parameter is set to 0, power-fail recovery is not 


attempted. This can cause file system corruption, lost I/O, and 
similar problems if a power failure occurs. 
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procs 


Description 

The procs parameter specifies the number of entries in the 
Process Table. Each entry represents an active process on the 
system (the ps command displays the Process Table). 


Range: 50 - 200 


Default: | 5000/20/40: 65 
5000/30/35/50/55: 70 


Size: 72 bytes per entry in the Process Table 


When to Change 


If processes are prevented from forking (being created), then the 
procs parameter should be increased. 


NOTE: 


Be sure that the prevention of forking is a system-wide 
problem, not just a user ID problem (see the maxproc 
parameter). 


Recommended Values 

The system administrator should calculate the maximum number 
of processes which may run at the same time. The final value 
should include the following: 


- maximum number of user processes; 
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- one per terminal which is configured but not used; 


- eight for system processes (2 swappers, init, errdemon, 
cron, and 3 extras); and 


- one for each HPSIO board which is configured. 


Potential Problems 


If the procs parameter is too small, processes which try to fork 
(create a new process) receive the system error EAGAIN: No 
more processes. The shell returns the following error message 
for the same problem: fork failed: too many processes. 
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sabufs 


Description 


The sabufs parameter is included for compatibility with AT&T. 


Range: 0 
Default: 0 
Size: O (does not increase kernel size) 


When to Change 


The sabufs parameter should never be changed. 


Recommended Values 


The sabufs parameter should never be changed. 


Potential Problems 


None 
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sema 


Description 


The sema parameter specifies the inclusion of the routines for 
handling semaphores. Processes may use semaphores to 
coordinate execution with other processes by using the semget, 
semctl, and semop system calls. 


Range: 0-1 
Default: 1 
Size: O (does not increase kernel size) 


Although this parameter does not increase the kernel size, it does 
cause the related parameters (the parameters whose names begin 
with sem) to become effective. These related parameters can 
increase the kernel size. 


When to Change 


The sema parameter should be set to 1 if processes need to use 
semaphores. 


Semaphore sets remain on the system until they are specifically 
removed. The system administrator should use the ipes command 
to check for existing semaphore sets which are not currently in 
use, and remove them with the iperm command. 


Recommended Values 
The sema parameter should be set to 1 to permit the use of 


semaphores. Since this can increase the size of the kernel, sema 
should only be set if semaphores are actually used. 
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Potential Problems 
a If the sema parameter is not set: 


1. A semget, semctl, or semop system call returns the error 
Bad system call - core dumped. 


2. The ipes command displays: Semaphore facility not in 
system. 
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semaem 


Description 


The semaem parameter specifies the maximum value of an 
"adjust-on-exit" value for a semaphore in an undo structure. The 
"adjust-on-exit" value is added to the semaphore when the process 
terminates, to undo any operations which the process performed. 


Range: 1 - 32767 
Default: 16384 


Size: 0 (does not increase kernel size) 


When to Change 


The semaem parameter may be modified if the system 
administrator wants to increase or decrease the maximum value 
for an "adjust-on-exit" value in an undo structure. This parameter 
is closely related to the semvmx parameter (the maximum value 
for a semaphore). If semvmx is modified, then the system 
administrator should consider modifying the semaem parameter 
to match that value. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 
The default value for the semaem parameter should be adequate 


for most applications of semaphores. The semaem parameter 
should generally be the same as the semvmx parameter. 
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Potential Problems 
If the semaem parameter is too small, the semop system call 


which attempts to modify a semaphore with the UNDO flag set 
returns the error ERANGE: Result too large. 
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semmap 
Description = 
The semmap parameter specifies the number of entries in the 
Semaphore Map Table. The Semaphore Map Table is used to 
keep track of free areas in the system pool of semaphores. 
Range: 2 - 1024 
Default: 10 
Size: 4 bytes per entry in the Semaphore Map Table 
When to Change 
The semmap parameter may be modified if the maximum number 
of semaphores on the system (the semmns parameter) is | 
modified. ed 
Changing this parameter has no effect if the sema parameter is 
not set to 1. 
Recommended Values 
The default value for the semmap parameter should be adequate 
for most applications of semaphores. The value of the semmap 
parameter depends upon the number of semaphore sets, the 
number of semaphores per set, and the creation/deletion of 
semaphore sets. More entries in this table are required if the free 
semaphores become fragmented into small groups by the 
creation/deletion of semaphore sets. 

WZ 
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Potential Problems 


If the semmap parameter is too small, the system "loses" free 
semaphores when a semctl system call removes a semaphore set. 
These "lost" semaphores cannot be given to another semaphore 
set. 
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semmni 


Description 

The semmni parameter specifies the maximum number of 
semaphore sets on the system. Semaphores are created in sets. 
There may be more than one semaphore per set. This permits a 
process to modify more than one semaphore in a set at the same 
time. 

Range: 1 - 256 

Default: 10 


Size: 38 bytes per semaphore set 


When to Change 


The semmni parameter should be increased if more than the 
default number of semaphore sets are required by processes. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 
The default value for the semmni parameter should be adequate 


for most applications of semaphores. The semmni parameter may 
be increased to permit more semaphore sets on the system. 


Potential Problems 

If the semmni parameter is too small, additional semget system 
calls to create semaphore sets return the error ENOSPC: No 
space left on device. 


Setting the semmni parameter to a large value requires more 
memory to keep track of semaphore sets. 
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semmns 


Description 


The semmns parameter specifies the maximum number of 
semaphores permitted on the system. 


A semaphore set may contain more than one semaphore. 
Range: 1- 128 
Default: 60 


Size: 8 bytes per semaphore 


When to Change 


The semmns parameter may be increased if more than the default 
number of semaphores are required by processes. 


Changing this parameter has no effect if the sema parameter is 
not-set to 1. 


Recommended Values 
The default value for the semmns parameter should be adequate 


for most applications of semaphores. The semmns parameter may 
be increased to permit more semaphores on the system. 


Potential Problems 

If the semmns parameter is too small, additional semget system 
calls to create semaphore sets return the error ENOSPC: No 
space left on device. 


Setting the semmns parameter to a large value requires more 
memory to keep track of semaphores. 
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semmnu 


Description 


The semmnu parameter specifies the maximum number of undo 
structures in the system. An undo structure, which is set up on a 
per-process basis, keeps track of process operations on 
semaphores so that the operations may be "undone" if the process 
terminates abnormally. Each undo structure has an "adjust-on- 
exit" value for each semaphore. Whenever an operation is 
performed on the semaphore, the direct opposite action is 
reflected in the "adjust-on-exit" value in the undo structure. This 
value is added to the semaphore when the process terminates. 


The "undo" capability helps to ensure that a process that 
terminates abnormally does not cause other processes to wait 
indefinitely for a change to a semaphore. 

Range: 1 - 256 

Default: 30 


Size: (semume * 8) + 16 


When to Change 


The semmnu parameter may be modified if the system 
administrator wants to increase or decrease the number of undo 
structures permitted on the system. This parameter essentially 
limits the number of processes which can specify the UNDO flag in 
the semop system call to "undo" their operations on termination. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 
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Recommended Values 


The default value for the semmnu parameter should be adequate 
for most applications of semaphores. The semmnu parameter may 
be increased/decreased to increase/decrease the number of undo 
structures on the system. 


Potential Problems 
If the semmnu parameter is too small, the semop system call 


which attempts to set the UNDO flag returns the error ENOSPC: 
No space left on device. 
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semmsl 


Description 


The semmsl parameter specifies the maximum number of 
semaphores per semaphore set. 


Range: 1-32 
Default: 25 


Size: 2 bytes each 


When to Change 

The semmsl parameter may be increased if more than the default 
number of semaphores are required in a semaphore set by 
processes. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 
The default value for the semmsl parameter should be adequate 


for most applications of semaphores. The semmsl parameter may 
be increased to permit more semaphores per set. 


Potential Problems 
If the semmsl parameter is too small, additional semget system 


calls to create semaphore sets return the error EINVAL: Invalid 
argument. 
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semopm 


Description 


The semopm parameter specifies the maximum number of 
semaphore operations per semop system call. More than one 
operation may be requested per semop system call to provide the 
capability of checking/modifying the value of more than one 
semaphore in a set with one request. 


Range: 1-16 
Default: 10 


Size: 6 


When to Change 


The semopm parameter may be modified if the system 
administrator wants to increase or decrease the number of 
operations permitted per semop system call. This parameter may 
need to be increased if the semmsl parameter (number of 
semaphores per set) is increased, so that a process may 
check/modify all the semaphores in a set with one system call. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 


The default value for the semopm parameter should be adequate 
for most applications of semaphores. The semopm parameter may 
be increased/decreased to increase/decrease the number of 
operations per semop system call. 
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Potential Problems 
If the semopm parameter is too small, the semop system call 


which attempts to perform too many operations returns the error 
E2BIG: Arg list too long. 
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semume 


Description 


The semume parameter specifies the maximum number of undo 
entries per structure. Each undo entry represents a semaphore 
which has been modified with the UNDO flag specified in the 
semop system call. 


Range: 1-16 
Default: 10 


Size: Depends on semmnu parameter 


When to Change 


The semume parameter may be modified if the system 
administrator wants to increase or decrease the number of undo 
entries per structure. This parameter is closely related to the 
semopm parameter (the number of operations per semop system 
call). If semopm is modified, then the system administrator should 
consider modifying the semume parameter to match that value. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 
The default value for the semume parameter should be adequate 


for most applications of semaphores. The semume parameter 
should generally be the same as the semopm parameter. 


Potential Problems 
If the semume parameter is too small, the semop system call 


which attempts to set the UNDO flag returns the error EINVAL: 
Invalid argument. 
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semvmx 


Description 


The semvmx parameter specifies the maximum value for a 
semaphore. This is used to prevent wraparound. 


Range: 1 - 32767 
Default: 32767 


Size: 0 (does not increase kernel size) 


When to Change 


The semvmx parameter may be decreased if the system 
administrator wants to limit the maximum vaiue for a semaphore. 


Changing this parameter has no effect if the sema parameter is 
not set to 1. 


Recommended Values 
The default value for the semvmx parameter should be adequate 


for most applications of semaphores. The semvmx parameter may 
be decreased to limit the value for a semaphore. 


Potential Problems 
If the semvmx parameter is too small, additional semop system 


calls to change the value of a semaphore return the error 
ERANGE: Result too large. 
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shmall 


Description 


The shmall parameter specifies the maximum number of clicks (2K 
segments of memory) which may be used for shared memory 
segments on the system. 


Range: 1 - 256 (2K - 512K) 
Default: 256 (512K) 


Size: 2048 bytes for each click of memory used for shared 
memory segments 


When to Change 


The shmall parameter may be decreased if the system 
administrator wants to limit the amount of memory which can be 
used for shared memory segments. This may be desired if 
swapping is occurring because large amounts of memory are 
being used for shared memory segments. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 


The default value for the shmall parameter sets the maximum 
number of clicks permitted for shared memory segments to the 
largest possible value. This may be decreased if the maximum 
amount of memory for shared memory segments needs to be 
smaller. 


Potential Problems 


If the shmall parameter is too large, excessive amounts of 
memory may be used for shared memory segments, causing 
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swapping of processes (the shared memory segments cannot be 
swapped). The swapping activity decreases system performance. 


If the maximum number of clicks for shared memory segments is 


reached, additional shmget system calls return the error ENIVAL: 
Invalid argument. 
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shmbrk 


Description 

The shmbrk parameter specifies the number of clicks (2K 
segments of memory) between the end of the data segment and 
the beginning of the first shared memory segment, if the default 
starting address is used. This permits a process to use the sbrk 
or brk system call later in the program to dynamically expand its 
data segment without overwriting the shared memory segment. 
Range: 0 - 480 (0 - 960K) 

Default: 16 (32K) 


Size: O (does not increase kernel size) 


When to Change 

The shmbrk parameter should be increased if processes which use 
both shared memory segments and the sbrk or brk system calls 
require more space for the dynamic data segment expansion. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 

The default value for the shmbrk parameter should be adequate 
for most applications of shared memory segments. The shmbrk 
parameter may be increased to permit larger dynamic data 
segment expansion. 


The value of shmbrk must be a multiple of 16 (82K). 
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Potential Problems 


If the shmbrk parameter is too small, additional sbrk or brk 
system calls to dynamically expand the size of the data segment 
cause data to overlay the shared memory segment. 


Setting the shmbrk parameter to a large value does not affect 


system or process performance, unless the logical limit of user 
address space is reached. 
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shmem 


Description 


The shmem parameter specifies the inclusion of the routines for 
handling shared memory segments. Processes may share data 
segments in memory by using the shmget, shmctl, shmat, and 
shmdt system calls. 


Range: O-1 
Default: 1 
Size: O (does not increase kernel size) 


Although this parameter does not increase the kernel size, it does 
cause the related parameters (the parameters whose names begin 
with shm) to become effective. These related parameters can 
increase the kernel size. 


When to Change 


The shmem parameter should be set to 1 if processes need to use 
shared memory segments. 


Shared memory segments remain on the system until they are 
specifically removed. The system administrator should use the 
ipcs command to check for existing shared memory segments 
which are not currently in use and remove them with the iperm 
command if they are wasting memory unnecessarily. 


Recommended Values 


The shmem parameter should be set to 1 to permit the use of 
shared memory segments. Since this can increase the size of the 
kernel, shmem should only be set if shared memory is actually 
used. 
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Potential Problems 
If the shmem parameter is not set: 


1. A shmget, shmctl, shmat, or shmdt system call returns the 
error Bad system call - core dumped. 


2. The ipcs command displays Shared Memory facility not in 
system. 


Shared memory segments are never swapped. If large amounts 


of memory are reserved for shared memory segments, swapping 
activity may increase (and system performance decrease). 
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shmmax 


Description 


The shmmax parameter specifies the maximum size (in bytes) of a 
shared memory segment. 


Range: 0Ox800 - 4x 0x8000 
Default: 4 x 0x8000 


Size: O (does not increase kernel size) 


When to Change 


The shmmax parameter should be decreased if the system 
administrator wants to limit the size of shared memory segments. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 
The default value for the shmmax parameter permits shared 


memory segments to be as large as possible. The value may be 
decreased to limit the size of shared memory segments. 


NOTE: 


The shmmax parameter MUST be less than the shmall 
parameter. 
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Potential Problems 
If the shmmax parameter is too small, a shmget system call to 


create a new shared memory segment larger than the limit returns 
the error EINVAL: Invalid argument. 
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shmmin 


Description 


The shmmin parameter specifies the minimum size (in bytes) of a 
shared memory segment. 


Range: 1 - 1024 
Default: 1 


Size: O (does not increase kernel size) 


When to Change 


The shmmin parameter may be increased if the system 
administrator wants to set a larger minimum size for shared 
memory segments. This parameter normally does not need to be 
changed. However, if all usage of shared memory segments is for 
a specific application, and an error message is desired if a process 
requests a shared memory segment which is too small, this 
parameter may be increased to force that error. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 


The default value for the shmmin parameter sets the minimum 
size of a shared memory segment to 1 byte. This may be 
increased if the minimum size of a shared memory segment needs 
to be larger. 
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NOTE: 


The shmmin parameter MUST be less than the 
shmmax parameter. 


Potential Problems 
If the shmmin parameter is too large, a shmget system call to 


create a new shared memory segment smaller than the limit 
returns the error EINVAL: Invalid argument. 
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shmmni 


Description 


The shmmni parameter specifies the maximum number of shared 
memory segments permitted on the system at any one time. 


Range: 1 - 256 
Default: 64 


Size: 30 bytes per shared memory segment permitted 


When to Change 

The shmmni parameter should be increased if many processes are 
using many shared memory segments so that this limit is reached. 
This parameter may be decreased to reduce the amount of kernel 
space taken for shared memory segments. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 


The shmmni parameter should be increased by 1 for each 
additional shared memory segment which is required. 


Potential Problems 
If the shmmni parameter is too small, a shmget system call to 


create a new shared memory segment returns the error ENOSPC: 
No space left on device. 
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shmseg 


Description 

The shmseg parameter specifies the maximum number of 
attached shared memory segments per process. A process must 
attach a shared memory segment before the data may be 
accessed. 

Range: 1 - 30 

Default: 6 


Size: 52 bytes per attached shared memory segment 


To determine the maximum amount of kernel space required for 
this parameter, use the following formula: 


52 * shmseg * procs 


The amount in use at any one time is 52 bytes times the number 
of attached shared memory segments. 


When to Change 


The shmseg parameter should be increased if processes need to 
use more than the default (6) number of shared memory 
segments at one time. 


Changing this parameter has no effect if the shmem parameter is 
not set to 1. 


Recommended Values 


The default value for the shmseg parameter should be adequate 
for most applications of shared memory segments. The shmseg 
parameter should be set to the smallest value possible to limit the 
amount of memory required to keep track of the attached 
segments. 
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Potential Problems 


If the shmseg parameter is too small, additional shmat system 
calls to attach shared memory segments return the error EMFILE: 
Too many open files. 


If the shmseg parameter is too large, the potential amount of 


memory required to keep track of attached shared memory 
segments increases. 
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sti 


Description 


The sti parameter specifies that the kernel is being used in a 
cartridge tape installation of the system software. 


Range: O-1 
Default: 0 
Size: 0 (does not increase kernel size) 


When to Change 
The sti parameter should only be set to 1 if the root file system 
resides in the swap area. This only occurs during a tape 


installation. Therefore, the sti parameter should not need to be 
changed by users. 


Recommended Values 


The sti parameter should be set to 1 for a tape installation. 
Otherwise, the default value of 0 should be used. 


Potential Problems 


None 
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swapmap 


Description 


The swapmap parameter specifies the number of entries in the 
Swap Map Table. This table is used to keep track of the unused 
contiguous free areas of the swap area. Each entry represents a 
free area in the swap area. 


Range: 50 - 100 
Default: 75 


Size: 4 bytes per entry in the Swap Map Table 


When to Change 


The swapmap parameter should be increased if the size of the 
swap area is increased, or if the error message (see the "Potential 
Problems" that follows) is received. 


The number of entries required in this table depends upon the 
fragmentation of the swap space - more entries are required if the 
swap space becomes very fragmented. The fragmentation 
depends upon the number of processes on the system, their sizes, 
the amount of available memory, and the amount of swapping 
which is occurring. 


Recommended Values 


The swapmap parameter should be increased by 10 each time it 
needs to be increased. 


See Chapter 2 for the procedure on how to look at the Swap Map 
Table. 
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Potential Problems 
If the Swap Map Table runs out of entries, swap space is lost (the 


system cannot keep track of the free area), and the error message 
DANGER: mfree map overflow is displayed on the console. 
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swexp 


Description 


This configuration parameter applies to the 5000/30/35/50/55 
Release 2.00 only. 


The swexp parameter activates the swap-allocated-with- memory 
or "swap expand" feature. When this parameter is set to 1, the 
required swap space is allocated at the same time that memory is 
allocated. This makes sure that a process can be swapped if 
necessary (if there is not enough swap space, an error Is 
generated when the memory allocation is attempted). 


The limitations of the swap expand feature are: 
- If the size of the swap space is less than the amount of 
physical memory, all of physical memory is not used (the 


virtual address space is equal to the swap space). 


- The superuser (root user) is not limited by this feature (so 
that processes can be terminated). 


Range: O-1 
Default: 0 
Size: @) 


When to Change 
Set the swexp parameter to 1 if the system load and growth of 


processes is not predictable AND increasing swap space is 
unacceptable (possibly because there is not enough disk space). 
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Recommended Values 

Set the swexp parameter to 1 to select the swap expand feature. 
Leave this parameter at the default value of O for normal memory 
and swap allocation. 


Allocation of the swap space does cause system overhead, which 
affects performance. Only select this feature when necessary. 


Potential Problems 

If the swexp parameter is set to 1 and the system runs out of 
swap space OR memory, a process that tries to allocate memory 
receives the error ENOMEM: Out of space. 


The process may produce a core dump instead of generating the 
error message. 


NOTE: 


There is not way for a process to tell if the system ran 
out of swap space or memory space. 


If the swexp parameter is set to 1 and the system runs out of 
swap space, the shell returns the following error during a fork: 


NO STACK SPACE 
CANNOT FORK: NO SWAP SPACE 


The shell that tried to start the process is hung, terminate all 
processes on the terminal to recover. 
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texts 


Description 

The texts parameter specifies the number of entries in the Text 
Table. Each entry represents an active shared text file in the 
system. When a shared (or pure executable) text file is executed, 
all processes executing the file share one copy of the text 
segment. Information regarding the text file and the number of 
processes using it needs to be kept in the Text Table. See 
Chapter 2 for more information on shared text. 


A shared text file is created by using the -n option on the Id 
command. 


Range: 5000/20/40: 20 - 50 
5000/30/35/50/55: 20 - 100 


Default: 40 


Size: 16 bytes per entry in the Text Table 


When to Change 

The texts parameter should be increased if the total number of 

active shared text files in the system exceeds the current setting. 
NOTE: 


A shared text file which has executed and had the 


sticky permission bit set is considered active and still 
has an entry in the Text Table, even if no process is 
currently using it. | 


UP-12715 R1 1-105 


Chapter 1 


Recommended Values 


If a system exceeds the limit of this parameter, the system 
administrator should evaluate the number of processes running at 
the time the value was exceeded and compare that to the number 
of processes at maximum load. The texts parameter should be 
increased accordingly. 


In addition, add one for each shared text file with the sticky 
permission bit set which may be executed. 


Potential Problems 
If the texts parameter is too small, an exec system call fails and 


the message out of text is displayed upon the console for each 
failed exec. 
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tslice 


Description 


The tslice parameter specifies the CPU time slice for processes (in 
hundredths of a second). The time slice is the maximum amount 
of time a process can execute before another process is allowed 
to execute. This provides flexiblity in the sharing of the CPU. 


Range: 1- 5400 (hundredths of a second) 
Default: 100 (1 second) 


Size: O (does not increase the size of the kernel) 


When to Change 


If some applications on the system are CPU-bound (performing 
many computations) and interactive (terminal) users are seeing 
slow response time, the tslice parameter may need to be 
decreased. 


Changing the time slice does not increase the throughput of the 
system; however, it does give the interactive users the feeling that 
their programs are running faster (better response time). 


If a Demand-Paging system is overloaded such that the entire time 
slice for a process is spent bringing its pages into memory, the 
time slice may need to be increased. See Chapter 2, "Use of 
Memory," for more information. 


Recommended Values 


The tslice(2) system call should be used to test different values for 
the tslice parameter without reloading the system. The time slice 
should be varied until a balance is reached between the CPU- 
bound applications and the interactive users. 
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Potential Problems 


If the time slice is small, the system overhead for switching 
processes in and out of the CPU is increased. The value of tslice 
which is chosen must weigh this increased overhead against the 
response time gains for interactive users. 


If the time slice is large, interactive users may see poor response 
time (long delays in terminal response). 
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General Purpose Transaction Facility (GPTF) 


This configuration parameter applies to 5000/30/35/50/55 Release 
2.00 only. 


How to Configure for GPTF 


This section discusses parameters that must be set with the config 
command when configuring your system to use GPTF. The 
following parameters are specific to GPTF: 


gptf includes the GPTF features in the kernel. 

dkpri is the disk I/O priority value. 

minnonres is the minimum amount of memory (in 2K 
clicks) that must be available for nonresident 
processes. 

nocheck enables resident processes to define and 


Operate on shared-memory segments 
without being checked against system 


parameters. 

ntimers is the maximum number of available timer 
structures. 

sema enables you to define and use both GPTF 


semaphores and standard semaphores. 


shmem enables you to define and use shared 
memory. 


The gptf parameter must be set to the value 1 if you are 
configuring your system to use GPTF. 


The dkpri parameter must be set to a value in the range 0 to 127 
when configuring to use GPTF. This parameter is discussed in 
detail in the following section called "How to Set Up Disk 1/O 
Priority." 
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The amount of memory you allocate to nonresident processes with 
the minnonres parameter depends on the requirements of your 
key resident and nonresident processes, and the total amount of 
available memory in your system. The default value is 100 2K 
clicks (200 kilobytes). 


The nocheck parameter can increase the potential performance of 


resident processes operating on shared-memory semaphores. Set 
this parameter to the value 1 for no parameter checking. 


CAUTION: 


Configure and use this parameter cautiously because it 


permits you to bypass protections on the memory 
space of the kernel. 


The ntimers parameter sets the boundary for the maximum 
number of GPTF timers you permit a process to use. 


The sema parameter must be set to 1 to use GPTF semaphores 
(sema also permits use of standard system semaphores). 


The shmem parameter must be set to 1 to use shared memory. 


Related Configuration Parameters 


When using GPTF shared-memory semaphores, the shmmax, 
shmmin, shmmni, and shmseg configuration parameters should 
be considered. These parameters define the size and number of 
shared-memory segments that can be made available. 


The buffers parameter specifies the number of system buffers to 
dedicate to disk I/O. If your environment is heavily centered on 
disk-intensive operations, such as price look-ups and other data 
base scanning, increasing this parameter may improve your I/O 
throughput. 
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For more details on configuration parameters, see _ the 
"Configuration Parameters" section of this chapter. 


How to Set Up Disk I/O Priority 


Standard UNIX operating systems sort processes for disk I/O by 
seek distance only. Seek distance is the distance that the disk 
head must travel to locate a file for reads or writes. With GPTF, 
you can schedule a process for disk I/O according to the priority 
of the process, the relative seek distance required to service the 
process, or both. 


The priority range for scheduling disk I/O (0 through 127) matches 

the process priority range. Using the dkpri configuration 

parameter, you can set the mix of priority and seek distance for all 
processes that access the I/O driver. 

Here’s how it works. If you set the dkpri to the value: 

0 all disk I/O is in the same category. Therefore 
processes are sorted by seek distance only. 

1 three priority groups for disk I/O are defined. 
Within each group, disk I/O requests are sorted by 
seek distance. The three groups are as follows: 

0 through 39 = kernel processes 

40 through 79 = real-time processes 

80 through 127 = time-sharing processes 
The default and recommended value is 1. 

ter Disk I/O priorities match process priorities one-for- 
one and the seek distance is not factored in. This 
value causes low throughput and is_ not 


recommended. 


If you assign dkpri a value other than 0, 1, or 127, the value 
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determines the number of groups within which each request is 
sorted according to seek distance. For example, if you assign 
dkpri the value 8, eight indexes are defined for the sort table. 
Within each of the eight groups, processes are sorted by seek 
distance. 


For more information on GPTF functionality see the U 5000/20, U 


5000/30, U 5000/35, U 5000/40, U 5000/50, and U 5000/55 System; 
U 5000 Series Operating System; Administration Guide. 
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Chapter 2. 
Use of Memory 


Introduction 


Main memory refers to the hard-wired random access memory of 
a computer; i.e., that part of a computer where programs and data 
are stored, and where processors can readily read and write 
information during program execution. The Central Processing 
Unit (CPU) can only reference code and data that is loaded into 
main memory. Therefore, a process (at least some portion of it) 
must be in main memory to be executed. 


If there is not enough space in main memory for all processes on 
the system, some processes are copied to a special area on the 
root device called the swap area. The swap area acts as 
secondary memory (holds what won't fit in main memory). 


Swapping of processes decreases system performance. The 
system must spend CPU and I/O time to copy processes in and 
out of memory--time which would otherwise be spent executing 
processes. 


To gain the maximum performance from a system, memory must 
be used as effectively as possible. Swapping, if it must occur, 
should be as infrequent as possible. Improving memory use may 
include optimizing the size of the kernel, reducing the size of user 
processes, reducing the number of processes on the system, 
sharing text among processes, etc. 


NOTE: 


The only solution to avoid swapping activity may be to 
add more memory to the system. 
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The following items take up memory space and should be 
considered when attempting to improve memory use: 


kernel structures 


drivers 


system processes 


user processes 


shared memory segments 


semaphore sets 


message queues 


2-2 


The system tables, buffer area, 
etc. whose sizes are determined 
by the configuration parameters 


The device drivers which are 
linked into the kernel (Such as 
HPSIO terminal driver, cartridge 
tape driver, etc.) 


Various processes which the 
system activates (such as _ init, 
getty, sh, etc.) 


Processes activated by users for 
applications. These processes 
may be set up to share text 
between multiple users of the 
same program. 


Shared memory segments used 
by processes (if the routines are 
included in the kernel) 


Semaphore sets (if the routines 
are included in the kernel) 


Message queues (if the routines 
are included in the kernel) 
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NOTES: 


If the routines for semaphore sets and message 
queues are included in the kernel, memory Is 
automatically reserved for these structures, even 
if they are never used. 


The ipces command may be used to determine if 


the Inter-Process Communication (IPC) facilities 
(shared memory, semaphores, and message 
queues) are included in the kernel. 


The sar -w command displays information about 
swapping activity, to help you determine if 
swapping is actually taking place. See Chapter 
5, "Testing Tools," for more information about 
the sar command. 


The Kernel 


This section describes the sizes of the kernel structures, the sizes 
of the Inter-Process Communication (IPC) structures, the drivers 
included in the kernel, and the logical address space required. 
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Kernel Structures Affecting the Size of the Kernel 


Table 2-1. Size of Kernel Structures 


Size 
Parameter | (bytes) 


For example, the size required for the default number (175) of 
Open File Table entries (files parameter) is: 


Total size = 175 * 12 = 2100 bytes 


Size of Kernel Structures 


The sizes of the configurable kernel structures are determined by 
the values for the configuration parameters in /etc/master or your 
cf file. Table 2-1 lists the configuration parameters for the kernel 
structures which increase the kernel size. 


If any of these configuration parameters are modified, then the 
total size required for the structure must be recalculated. 
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NOTE: 


The kernel maintains a Page Table for each process 
which is currently on the system. This table keeps 
track of the pages (clicks or 2K pieces) of the process. 
The memory for this table is dynamically allocated 
when the process starts, and is freed when the 
process terminates. The amount of space required is: 


5000/20 2K for each active process 
5000/40 2K for each active process 


5000/30/35/50/55 4K for each active process. In 
addition, if the | maxspace 
parameter is increased, an 
additional 2K is required for each 
increase of 1MB in the user 
address space. 


The space for the Page Tables must also be 
considered part of the amount of memory required for 
the kernel. If this space is not available, the system 
either displays the message kernel too big on the 
console or halts with a panic: Out of System Page 
Table Resources message, depending on the severity 
of the shortage. 


Size of IPC Structures 


If any of the following IPC configuration parameters are set to 1, 
additional memory is required: 


shmem Shared memory segments 
sema Semaphores 
UP-12715 R1 
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mesg Message queues 

Table 2-2 lists the configuration parameters for the IPC facilities 
which increase the kernel size, and the total size required for these 
structures using the default values for the parameters. 


If any of these configuration parameters are modified, then the 
total size required for the structure must be recalculated. 


Table 2-2. Configuration Parameters 


[Parameter | (in bytes) | Value | Size | 
‘shmseg |  _—s—si52.|__—ss6_—(|_—See NOTE 1 


semmnu, 
semume 
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NOTE: 


1. The size for the shmseg parameter is 52 bytes 
per currently attached shared memory segment. 


2. The amount of shared memory currently in use 
should also be added to the total for shared 
memory. 


3. The msgseg and msgssz parameters are 
multiplied together to determine the amount of 
space reserved for message queues. 


4. The code for the IPC system calls also increases 
the kernel size. 


Size of Drivers 
The device drivers which are linked into the kernel also take 


memory space. Table 2-3 lists the sizes of the supported device 
drivers, along with any special comments required. 
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Table 2-3. Device Driver Sizes 


Driver Comments 


Size 
orl AM Bal FA 
not present 
5.25" Disk Driver 


SCSI Disk Driver 2 ee 
SOSI Magnetic Tape Driver | mK | 


If both drivers 
in kernel 
HPS1O Terminal Driver = eae 


K 
Additional HPSIO Board 4K For each 
additional board 


5.25" Cartridge Tape Driver | 12k | 


for SNA and BSC 
MPCA driver 

Ge Md = 
MPCA driver 


DDN- 5000 
UNI SCOPE 


PDN- 5000 
64 circuit 
32 circuit 


ET 1100 
APPC- 5000 
MUX- 5000 


For devices not listed or for more information, refer to the 


Software Release Description for your device driver. 
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Physical Kernel Size 


The total physical kernel size is the sum of all the features included 
in the kernel--the code, the configurable structures, the optional 
system calls, and the drivers. To approximate the total kernel size 
for a particular system, add the total for each of the following: 


1. Basic kernel code and the unconfigurable structures 
(approximately 207K bytes). This includes demand paging. 


2. If demand paging is NOT included, subtract 17K bytes. 


3. The total size of all the configurable kernel structures. 
Recalculate if any of the configuration parameters have 
been modified. 


4. The sizes of the IPC system calls, if included in the kernel: 
IPC routines approximately 0.4K bytes (required 
once for IPC facilities) 
Shared Memory approximately 4.4K bytes 
Semaphores approximately 3.8K bytes 
Messages approximately 2.3K bytes 
5. The sizes of the configurable features for the IPC facilities, if 


included in the kernel. Recalculate if any of the parameters 
are modified. 


6. The sizes of the drivers which are included in the kernel. 


7. The amount of memory required for the Page Tables for 
each active process. 


The previous procedure determines the physical memory 
requirements for the kernel. You must also consider the 
limitations in the logical address space for the kernel, which is 
explained on the following section. 
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Be sure you understand the difference between the following: 


- Physical Memory -- The total available memory for the 
system. The kernel and user processes use physical 
memory. 


- Kernel Address Space -- The logical size limitation for the 
kernel size: 1MB on a_ 5000/20/40; 2MB on a 
5000/30/35/50/55. This limitation includes all the features 
listed previously, plus some reserved areas explained in the 
"Kernel Logical Address Space" section that follows. 


- User Address Space -- The logical size limitation for each 
process: 1MB on aé_ 5000/20/40; up to 14MB on a 
5000/30/35/50/55. This includes the user code, data, stack, 
and shared memory segments. 


Kernel Logical Address Space 

The logical address space for the kernel is limited to: 

1MB 5000/20/40 

2MB 5000/30/35/50/55 

This logical address space includes some logical areas which are 
automatically reserved. These areas are not configurable and do 


not take physical memory space. 


To determine the logical address space for a kernel, add the 
following: 


192K Logical address space which is automatically 
reserved and cannot be changed. 


64K * kins Logical address space reserved for drivers 
which use 64K addressable areas in the kernel. 
This area is reserved based on the value of the 
kins parameter, even if a driver which uses one 
of these areas is not included in the kernel. 
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64K *n 


32K 


Logical address space reserved for DMA 
segments for drivers. On a 5000/20 system 
only n is the number of drivers from the 
following list which are included in the kernel: 


5.25" cartridge tape driver 
8" disk driver 

MPCA driver 

SCSI tape driver 


If the 5.25" cartridge tape driver is included in 
the kernel, it dynamically allocates this space 
during an open of the tape drive. This should 
be considered just like reserved space (if there 
is not room for this dynamic expansion, the tape 
drive cannot be opened or used). 


The physical size of the kernel, as determined 
using the procedure in this section. 


The total from this addition must be less than the logical address 
space for the kernel (1MB for the 5000/20/40, 2MB for the 
5000/30/35/50/55). 


Example Kernel Sizes 


Typical 5000/20/40 Kernel 


The following is an estimation of the kernel size for a typical 


5000/20/40: 
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Physical Size of Kernel: 


207K for the base kernel code and structures 

82K for the default values of the configurable kernel 
structures 

60K for the expansion of the system buffer area to 100K 
(from 40K) 

16K for the 5.25" disk driver 

18K for the terminal driver 

12K for the 5.25" cartridge tape driver 

395K TOTAL physical memory 


Logical Address Space for Kernel: 


192K automatically reserved 

64K for the kIns area (the default value of kins is 1) 

160K for the DMA segments for drivers (5.25" tape, 5.25" 
disk, HPSIO) : 

32K for the dynamically allocated space used by the tape 
driver 

395K for the physical space required 

843K TOTAL logical address space for 5000/20 (683K for 
5000/40) 


NOTE: 


Up to 130K (2K * procs) may be dynamically allocated 


for the Page Tables for active processes. 130K is the 
maximum amount of memory required for the Page 
Tables. 


Typical 5000/30/35/50/55 Kernel 


The following is an estimation of the kernel size for a typical 
5000/30/50: 
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Physical Size of Kernel: 


207K for the base kernel code and structures 
324K for the default values of the configurable kernel 
structures 
16K for the 5.25" disk driver 
18K for the terminal driver 
4K for an additional HPSIO board for the 5.25" 
cartridge tape driver 
581K TOTAL physical memory 


Logical Address Space for Kernel: 


192K automatically reserved 

64K for the kIns area (the default value for kins is 0) 

32K for the dynamically allocated space used by the tape 
driver 

581K for the physical space required 

869K TOTAL logical address space 


NOTE: 


Up to 320K (4K * procs) may be dynamically allocated 


for the Page Tables for active processes. The 
maximum amount of memory required for the Page 
Tables is 320K. 


System Processes 


The processes listed in Table 2-4 are activated by the system and 
generally execute on every system. These processes are 
considered “user processes" in terms of memory use, since they 
are not part of the kernel. Table 2-4 may be used to help 
determine the memory requirements for these system processes. 
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Table 2-4. System Process Memory Requirements 


Sharable Non- sharable 
Portion Portion | Comments 


NE Aa = 
every system 
every system 


One for each 
defined terminal 
at the initial 

login prompt 


| Process | 


One for each 
terminal that 
is currently 
logging in 


One for each 
terminal that is 
currently logged 
in with the 
standard shell. 
Also one per 
shellscript 
currently running. 
One per HPSIO 
controller, 
always executing 


image 
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Table 2-4. System Process Memory Requirements (cont.) 


Sharable Non- sharable 
Process Portion Portion Comments 


58K One per system, 
always executing 


Ipd 54K One per printer, 


(spooler ) only executing 
when files are 
printing 


Ip One per printer, 
(spooler ) only executing 
when files are 
printing 


User Processes 


User processes vary in size. There are 6 main parts of a process 
which should be considered when estimating the memory 
requirements for a process: 


System Data Segment The system information for the 
process (such as open files, current 
directory, etc.). 


Text Segment The text (instruction code) for the 
process. This may be shared with 
other processes. 


Initialized Data Data which has been _ initialized 
(pre-set) to a value. 


Uninitialized Data Data which has not been initialized 
to a value (initially set to 0). 
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Shared Memory Segments Shared memory segments used by 
a process. The physical memory 
for the segment is only reserved 
once. However, the size of the 
shared memory segment is 
considered part of the user 
address space for the process. 


Stack The stack for the process (contains 
function return addresses and local 
variables). 


The size of each of these areas is dependent upon the size and 
actions of the process. The best method to determine the size of 
a process is: 


1. Execute the command: ps -el 
Note the value in the F (flag) field. If the flag field has a 
value of 101 or 100, then the process is using shared text. 
Otherwise, the process is using non-shared text. 


2. Multiply the value in the SZ (size) field by 2K. If the process 
is using non-shared text, this is the amount of memory the 
process requires. If the process is using shared text, 
continue to Step 3. 


3. Execute the command: size process-filename 
Add the first value specified (the text size) to the value from 
Step 2. This is the total amount of memory this process 
requires. 


If it is not possible to check the size of a process while it is 
executing, the following procedure may be used to estimate the 
memory requirements for the process: 


1. Execute the command: size process-filename 


The values listed are the sizes of the text area, the initialized 
data area, and the uninitialized data area, respectively. 
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2. If the process uses shared memory, add the size of the 
shared memory segment(s). 


3. Add approximately 4K for the System Data Segment and 6K 
for the stack. The total of all 3 steps is an ESTIMATION of 
the memory requirements for the process. 


Remember: This is only an estimate. 


Memory Requirements Estimation 


This section provides example’ estimations of memory 
requirements for a system. Assume that the system has the 
following characteristics: 

- 5000/40 

- 10 defined terminals 


- Users use the standard shell and an application which requires 
128K 


- Average of 6 terminals logged in at one time 
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Estimation of Physical Kernel Size 


for the base kernel code and structures 

for the default values for configurable parameters 
for buffer area expansion (100K from 40K) 

for clists expansion (300 clists from 150) 

for HPSIO terminal driver 

for extra HPSIO board 

for 5.25" cartridge tape driver 

for 5.25" disk driver 


TOTAL 


Estimation of Size of System Processes 


8K 
51K 
129K 
64K 
120K 
60K 
32K 
58K 


522K 


for. the swappers 

for /etc/init 

for /etc/getty processes (average of 4) 
for the first shell process 

for the additional 5 shell processes 

for the two Idhpsio processes 

for errdemon 

for /etc/cron 


TOTAL 


Estimation of Size of User Processes 


768K 


for an average of 6 users 
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Estimation of Total Memory Requirements 


409K for the kernel (physical memory) 
522K for the system processes 
768K for the user applications 


1699K TOTAL 


The total equals approximately 1.7MB, so 2MB of memory should 
be adequate. 


Determining Free Kernel Space 


After a system has been configured and is running, you may want 
to determine the amount of kernel space available for the Page 
Table entries for processes. This is actually the number of 
processes which may run on the system, and may be used as the 
value for the procs parameter. 


The system structure sptmap keeps track of the free areas in 
kernel logical memory space. Each entry has the following format: 


2 bytes Size: the number of free clicks in this area 


2 bytes Address: the click offset from the beginning of the 
kernel logical memory area where this free area 
begins. 


The first entry in sptmap is used to keep track of the number of 
free entries in the table. Therefore, the first 4 bytes of this table 
may be ignored. 


The general procedure to determine the amount of space left in 
the kernel logical memory space is to add the sizes of all free 
areas in sptmap and add the amount of memory used for the 
Page Table entries of current processes. The detailed procedure 
follows. 


This detailed procedure can be used to determine the amount of 
kernel space left on a running system for Page Table entries: 
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Enter adb and display the first 40 bytes of sptmap. 


adb /unix /dev/kmem 
This enters the adb utility. The first argument (/unix) is 
the filename of the kernel being used. If you booted 
with a different kernel when the system was booted, 
enter that filename instead. The second argument 
(/dev/kmem) is the kernel portion of memory. 


ready 
The response by the system when adb is ready for 
commands. 


sptmap,40/x 
Displays 40 words of memory, beginning at sptmap. 


0x4000 0x0000 0x0040 Ox0ab2 0x0020 0x0b40 0x0000 0x0000 

0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 
The first two words (0x4000 and Ox0000) may be 
ignored (indicate the number of entries in the table). 
Each entry following the first consists of two words. The 
first word is the number of free clicks in the area and 
the second word is the address. Add the number of 
free clicks (Ox0040 + Ox0020 = Ox0060 = 96 clicks 
decimal). 


$q 
This exits the adb utility. 


Determine the current number of processes on the system. 


ps -e |; wcec-l 
This determines the current number of processes on 
the system. For example, suppose the result of this 
command is 44. Subtract 2 processes for the ps and 
we commands. The result is 42 processes currently on 
the system. 
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3. Determine number of clicks available for processes. Ona 
5000/40 for example: 


96 Free clicks 
-16 Clicks for tape driver dynamic allocation 


80 Clicks free 
-15 Clicks extra for dynamic allocation by 
system processes 
65 Clicks free 
+42 Clicks for Page Table entries of processes 
already running 


107 Clicks available for processes 


4. Set the procs configuration parameter to 107 or less. 


NOTE: 


On the 5000/30/35/50/55 systems, Page Table entries 
are 4K (2 clicks each). In the previous example, 65 


clicks free + 84 clicks for Page Table entries of 
processes already running is equal to 149 clicks 
available for processes. Therefore, set the procs 
parameter to 74. 


Demand Paging vs. Swapping 


There are two methods which a kernel can use to handle 
processes in memory and the swapping of processes when 
memory Is full: 


Demand Paging The kernel keeps only the pages (2K pieces) 
of a process in memory which are required 
when it is executing. If memory is full, an 
entire process is swapped to the swap area. 
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When the process executes again, the 
pieces are brought in from the swap area. 


Swapping The kernel must keep an entire process in 
memory when it is executing. If memory is 
full, an entire process is swapped to the 
Swap area. When the process executes 
again, it must be copied back into memory 
in its entirety. 


Demand Paging is the default method for kernels to handle 
processes. Swapping may be selected instead by using the 
Update Operating System Software selection in the sa menus. 


If the amount of system memory is 512K, then Demand Paging 
MUST be used. Swapping may not be selected for a 
5000/30/35/50/55. 


The performance of a Demand Paging kernel, compared to a 
corresponding Swapping kernel, varies according to the degree of 
system load. 


1. If the system load is such that neither kernel must swap 
processes, the performance of the two kernels is roughly 
equivalent. The Demand Paging kernel may be slightly 
slower due to the overhead of dynamic page management, 
although the start-up time for processes is faster. 


2. If the system load is such that the Swapping kernel is 
forced to swap processes, but the "working sets" (pages in 
use) for processes is such that the Demand Paging kernel is 
not forced to swap, the Demand Paging kernel is 
approximately 1.6 to 2.0 times faster than the Swapping 
kernel. 


3. If the system load is such that both kernels must swap 
processes, but not excessively, then the Demand Paging 
kernel is approximately 1.2 to 1.6 times faster than the 
Swapping kernel. 


2-22 UP-12715 R1 


Use of Memory 


Swap Map Table 


The Swap Map Table keeps track of the free areas in the swap 
area. Each entry has the following format: 


2bytes Size: the number of blocks in this free area 


2bytes Address: the block offset from the beginning of the 
swap area where this free area begins 


The size of a "block" in each Swap Map Table entry is 1 physical 
block for the 5000/20/40, 64 physical blocks for the 
5000/30/35/50/55. 

The first entry in the Swap Map Table is used as follows: 

2bytes The number of free entries in the Swap Map Table 


2bytes Not used in the first entry (always 0) 


The last entry used in the Swap Map Table has zeroes (0) for both 
the size and address. 


The number of entries in the Swap Map Table is determined by the 
swapmap configuration parameter. 


Free Space in Swap Area 


5000/20/40 


The amount of free space in the swap area is determined by 
looking at the Swap Map Table and adding up the "size" fields for 
each entry which is in use. 


The adb utility may be used to look at the Swap Map Table. To 
make the procedure easier, the description which follows uses a 
file, swap.map, which contains the adb commands to display a 
Swap Map Table entry. The contents of this file are: 


UP-12715 R1 2-25 


Chapter 2 


UGA SN Ree WE EES INI A DAS SRAM I OOS AO NT SETS CaN LE CH 


/"Entry in Swap Map Table 
+/d"Number of blocks free area" 
+/x"Offset address of free area" 
+/"End of Swap Map Table entry" 


You must be the superuser (root) to look at the Swap Map Table. 
The following procedure may be used: 


adb /unix /dev/kmem 
This enters the adb utility. The first argument (/unix) is 
the filename of the kernel being used. If you booted with 
a different kernel when the system was booted, enter that 
filename instead. The second argument (/dev/kmem) is 
the kernel portion of memory. 


ready 
The response by the system when adb is ready for 
commands. 

swapmap/ 
This positions you to the beginning of the Swap Map 
Table. 


Swapmap: 0x480000 
The response by the system when you are positioned to 
the beginning of the Swap Map Table. The address 
(Ox48000) may be different for your system. 


$< swap.map 
This tells adb to take its input from the file swap.map. 
This file contains the instructions for adb to list one entry 
in the Swap Map Table. Remember that the first entry is 
the number of free entries in the table, not a free area. 


Swapmap: Entry in Swap Map Table 

swapmap: 72 Number of blocks in free area 
swapmapt+0Ox2: OxO Offset address of free area 
swapmapt+0x4: End of Swap Map Table entry 
ready 
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This is the result of the request; the first entry in the table, 
which identifies the number of free entries. In_ this 
example, 72 entries are still available, 3 are used, 
assuming the value of swapmap is 75, (default value). 


$< swap.map 


Displays the next entry in the Swap Map Table. 


swapmap+0Ox4: Entry in Swap Map Table 
swapmap+0Ox4: 7860 Number of blocks in free area 
Swapmap+0Ox6: Oxe9 Offset address of free area 
swapmap+0Ox8: End of Swap Map Table entry 

ready 


This is the result of the request; the next entry in the 
table, which describes the first free area. The size of the 
free area is 7860 blocks (512 bytes each) and the free 
area begins at block offset e9 (hexadecimal) from the 
beginning of the swap area. 


$< swap.map 


$q 


Displays the next entry in the Swap Map Table. Continue 
entering this command until the entry displayed contains 
a zero (0) in the size field. 


swapmap+0x8: Entry in Swap Map Table 
swapmap+0x8: O Number of blocks in free area 
Swapmap+Oxa: OxO Offset address of free area 
swapmap+Oxc: End of Swap Map Table entry 
ready 


This is the result of the request. This is the last entry 


used in the Swap Map Table; the first entry with a zero in 
the size field. 


This exits the adb utility. 


Add the size fields of all entries which are in use (except the first 
entry) to determine the total number of available physical blocks in 
the swap area. 
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The amount of free space in the swap area on a 5000/30/35/50/55 
is kept in a system variable called swapspace. The value of this 
variable is the number of 64 physical block sections of swap space 
which are available (multiply the value of swapspace by 64 to 
determine the number of physical blocks which are available). 


You must be the superuser (root) to inspect the value of 
swapspace. The following procedure may be used: 


adb /unix /dev/kmem This enters the adb utility. The first 
argument (/unix) is the filename of the kernel being used. 
If you used a different kernel when the system was 
booted, enter that filename instead. The second 
argument (/dev/kmem) is the kernel portion of memory. 


ready The response by the system when adb is ready for 
commands. 


swapspace/D This positions you to the swapspace variable which 
is displayed in decimal. To display the value in 
hexadecimal, replace the D with an X. 


Swapspace: 272 This is the result of the request; the number of 
64 block sections available in the swap area. In this 
example, there are 17408 (272 * 64) physical blocks 
available in the swap area. 


$q This exits the adb utility. 


On the 5000/30/35/50/55, the Swap Map Table may be inspected 
using the same procedure used for the 5000/20/40. Remember 
that each "block" in the size field on a 5000/30/35/50/55 represents 
64 physical blocks. Multiply by 64 to determine the number of 
physical blocks in the free area. 
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WARNING: 


Do NOT change the current sizes and block offsets for 


partitions 13 and 14. These partitions are reserved for 
installation, system restore, and _ file system 
maintenance using the INSTALL media. The 
installation procedure CANNOT continue if you change 
these partitions. 


Increasing Swap Space 


1. Perform Phase 1 of the installation procedures. Make sure 
that the disk is formatted and all bad blocks are entered. 
Note the type of hard disk being used as the root device. 
For this example, a disk type of AT47 (Atasi 5.25" 46MB) is 
used. 


2. Select Perform File System Maintenance at the beginning 
of Phase 2 of the installation procedure. 


3. Determine the number of 512-byte blocks to be allocated for 
the swap area (partition 15). For this example, 20000 blocks 
is used. 


4. Determine the modulus (the number of blocks per cylinder) 


for the root device. The modulus values for the different 
disk types are specified in Table 2-5. 
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Table 2-5. Disk Modulus Values | 


Disk Type 


Divide the number of blocks determined in Step 3 by the 
modulus determined in Step 4. For this example, 20000 / 
119 = 168.06722. Round the result up to the next integer 
(169 in this example). 


Multiply the result in Step 5 by the modulus determined in 
Step 4. For this example, 169 x 119 = 20111. This result 
is the size for partition 15 of the disk (swap area). 


Determine the current values for partitions 1 and 15 using 
the /etc/dkpart command. The device name varies (see the 
list provided in Step 11 of this procedure). For this 
example, the device name is: 


/etc/dkpart -d h501 

Write down the current sizes and block offsets for partitions 
13 and 14. For this example, partition 13 = 5000 blocks, 
offset 68187; partition 14 = 3092 blocks, offset 73187. 


Partitions 13 and 14 are reserved for installation, system 
restore, and file system maintenance using the install media. 
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The current sizes and block offsets are required and should 
not be changed. 


9. Subtract the current size of partition 15 from the size 
calculated in Step 6. For this example, partition 15 = 8092. 
Therefore, the result is 20111 - 8092 = 12019. This is the 
amount which must be subtracted from the root file system 
to make room for the increase in the swap area. 

10. Subtract the result from Step 9 from the current size of 
partition 1. For this example, partition 1 = 68187. 
Therefore, 68187 - 12019 = 56168. This is the new size for 
partition 1 (the root file system). 

11. Change the partition sizes and block offsets for the 
partitions by entering the values calculated in Steps 6 and 
10 using the following procedure: 

a. Create a file /tmp/file for this example. This file 
should have the size and block offset for each 
partition of the disk; one partition per line. An 
example listing of a file follows. Partition O must have 
a size of O and start at offset 0. 

00 

56168 0 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

5000 68187 

3092 73187 

20111 56168 
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b. Enter the following command: 
/etc/dkpart -p h501 </tmp/file 


c. Enter the following command and verify the partition 
sizes and offsets: 


/etc/dkpart -d h501 


The dkpart command changes the partition sizes to 
cylinder boundaries - this is correct. 


NOTE: 


In the previous examples, h501 is available on the 
5000/20/30/40/50. For other devices, see Table 2-6 
which show possible root devices. 
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Table 2-6. Root Devices 


5000/20/30/40/50 systems: 


Device Name h501: Internal Controller 0, Drive 1 


Optional for 5000/50 system: 
Device Name sd01: SCSI Controller 0, Disk 1 


5000/35/55 systems: 


Device Name sdai1: Internal Controller 0, Disk 1 


Optional for 5000/35/55 systems: 


Device Name sdb1: 
Device Name sd01: 
Device Name sd02: 
Device Name sd0s: 
Device Name sd11: 
Device Name sd12: 
Device Name sd13: 
Device Name sd21: 
Device Name sd22: 
Device Name sd23: 
Device Name sd31: 
Device Name sd32: 
Device Name sd33: 


Internal Controller 0, Disk 2 
External SCSI Controller 0, Disk 1 
External SCSI Controller 0, Disk 2 
External SCSI Controller 0, Disk 3* 
External SCSI Controller 1, Disk 1 
External SCSI Controller 1, Disk 2 
External SCSI Controller 1, Disk 3* 
External SCSI Controller 2, Disk 1 
External SCSI Controller 2, Disk 2 
External SCSI Controller 2, Disk 3* 
External SCSI Controller 3, Disk 1 
External SCSI Controller 3, Disk 2 
External SCSI Controller 3, Disk 3* 


*Available with 5000/55 expansion cabinet only. 


12. Enter < Ctrl > d to return to the installation menu and 
continue with the installation procedures. 


Shared Text 


Memory use by user processes may be improved by creating the 
executable object file as shared text (or "pure executable"). 


A shared text executable is created by using the -n option on the 


Id or cc command. 


UP-12715 R1 


2-33 


Chapter 2 


When an executable object is shared text, multiple processes 
executing the object share one copy of the text segment 
(instruction code) in memory. This saves memory space. The 
shared text segment is removed from memory when all processes 
using it terminate. 


Each shared text object which is currently in use on the system 
uses an entry in the Active Inode Table and an entry in the Text 
Table. The sizes of these tables may need to be increased if a 
large number of shared text objects execute on the system at the 
same time. 


The Sticky Bit 


The "sticky" permission bit (t-bit) may be set for shared text files. 
If the sticky bit is set, a copy of the shared text is kept in a 
contiguous area of the swap area after it has executed once, even 
if no process is currently executing the shared text. 


The advantage of setting the sticky bit is when the object file is 
executed again, the text segment is swapped in with one I/O 
operation (instead of one block at a time). This results in faster 
command start-up and improved response time. 


Each file that has executed at least once and has the sticky 
permission bit set uses the following resources: an entry in the 
Active Inode Table, an entry in the Text Table, and swap space. 
The table sizes may need to be increased if many objects have the 
sticky permission bit set. 


The text segment for the shared text object stays on the system 
until the system is brought down. On systems with limited swap 
space, all objects with the sticky permission bit set should be 
executed by a routine in /etc/re so that the swap area is not 
fragmented. 


Normally, it is not necessary to set the sticky bit for programs 
which are being run most of the time (sh, getty, etc.). 


To set the sticky permission bit for an executable object file, use 
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the following command: 


chmod +t file 


The sticky permission bit should be used with discretion — setting 
this permission bit unnecessarily wastes swap space and kernel 
resources, 


Summary 


The following procedure summarizes the different steps you may 
take to improve memory use: 


is 


Modify the kernel configuration parameters (see Chapter 1) 
so that all structures in the kernel are set to their most 
efficient size. 


The buffers parameter requires the most memory space. 


Only include the required device drivers in the kernel. The 
kernel should be manually relinked after removing a device 
driver from the system using the sa menus, if the menus 
did not relink the kernel (relinking is a user option). 


Do not include the IPC facilities of shared memory, 
semaphores, and message queues unless they are used by 
processes on the system. If these facilities are included, 
check the values of all associated parameters so that the 
space reserved is as small as possible. 


Check the user applications. If an application is executed 
by many users at the same time, recommend to the 
programmer that the executable object file be relinked as a 
shared text file. 


If the system does not currently have Demand Paging, 
install Demand Paging and test the performance. 
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6. If, after making the previous changes, swapping still affects 
system performance, add more memory to the system. 


NOTE: 


Turn to Chapter 7 and perform Exercise 2, "Use of 
Memory." 
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Chapter 3. 
Use of Disks 


Introduction 


Disk drives are devices used for long-term storage of large 
amounts of information. Aiong with magnetic tapes, disks are 
referred to as secondary memory. Information stored on disks (in 
files) is information which needs to be saved when the system 
reboots and accessed when processes are executing. 


Disks are organized into file systems. File systems contain the 
following sections: 


Superblock A single physical block which contains 
information about the file system - its size, 
free block list, free inode list, etc. 


I-list (inodes) A group of physical blocks which contain 
inodes. Inodes describe files - their type, 
permissions, size, owner, blocks, etc. 


Storage Blocks A group of physical blocks which contain 
data for files or are free. 


Files in a file system are referenced by their pathname. A 
pathname consists of a series of directories and then the filename 
itself. The location of a file may involve a search of a number of 
directories. 


Files are referenced frequently. Some examples of reasons for 
referencing a file are: 


- execution of a program (the executable object of the 
program must be read from disk into memory), 
- access of a data file by an executing process, and 


- search of a directory to locate a referenced file. 
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The system spends a large portion of its time accessing files on 
disks. Therefore, effective use of disks is very important for good 
system performance. There are two parts to use of disks: 


File System Organization The organization of the blocks in 
files on the disk and the free 
blocks on the disk. 


I/O Balancing The balancing of I/O requests 
among the available disks. 


As file systems are used, block allocation tends to become 
disorganized and I/O becomes less efficient. This disorganization 
causes inefficient ordering of blocks in files and_ inefficient 
directory structure. 


Ideally, disk I/O should be balanced among the available disk 
drives so that each drive is doing its share of the work. 


File System Organization 


As a file system is used and files change size or are removed, the 
efficiency of the I/O starts to decrease. This is because blocks for 
file expansion are out of sequence from the original blocks and 
blocks from removed files are placed at the beginning of the free 
block list. 


In addition, when several files are being created at the same time, 
they both contend for blocks from the free block list. Some of the 
blocks allocated to the files get out of sequence. 


The general trend is that files created during system installation 
are spaced very efficiently on the disk and files created after 
system use (user files) are not spaced as efficiently. 


The free block list for a file system is built when the file system is 


created. The organization of the free list affects the efficiency of 
access to the files created on the file system. 
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The software interleave factors, specified during the creation of the 
file system (by means of newfs or mkfs), determine the spacing of 
blocks on the free list. The software interleave factors are set up 
so that after the first block of a file is read, the second block is 
positioned at the read/write head just as the drive is ready to 
process the second request. 


For example, if the software interleave is 10, a file may consist of 
blocks 500, 510, and 520. When the file is read, requests are sent 
to the disk drive to read blocks 500, 510, and 520. As soon as the 
drive has read block 500 and begins to process the second 
request, block 510 is positioned at the read/write head. 


This organization of the free block list makes the I/O for files 
created early in the use of the file system more efficient than files 
created later. 


Restoring File System Organization 


There are two methods to help restore the efficiency of a file 
system: 


/etc/fsck -s Rebuilds the free block list to match the 
original software interleave factors. 


/etc/dcopy Optimizes a file system when copied to another 
disk. 


/etc/fsck -s 


The -s option of /etc/fsck reorganizes the free block list of a file 
system. The spacing of blocks in the free block list is reordered to 
be as close to the original software interleave factors (gap and 
modulus) as possible. 


This procedure ensures that blocks for future files are spaced as 


efficiently as possible. One of the times this may be useful is just 
before adding a new set of large files, such as a database. 
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The general procedure is: 
1. Enter single-user mode. 


2. Unmount any mounted hard disks (if the system has more 
than one disk). 


3. Execute /etc/fsck -s for each file system (perform on the 
root file system last). 


4. Reboot the system. 


5. Enter multiuser mode or add the desired application and/or 
files. 


NOTE: 


If a normal maintenance fsck is executed and it 


performs Phase 6: Salvaging Free List, the free list is 
reorganized as close to the original software interleave 
factors as possible. 


dcopy 

The dcopy command optimizes a file system and copies it to 
another file system of the same size (which usually resides on 
another disk). The optimizations include: 


- moving sub-directories to the beginning of directories (for 
faster pathname searches), 


- removing unused entries in directories, 
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- spacing the blocks in all existing files to match the software 


interleave factors, and 


- spacing the free block list to match the software interleave 


factors. 


Execution of a dcopy command provides an average of 10 to 15 
percent improvement in overall I/O throughput. The amount of 
improvement depends on the amount of disorganization which 
exists before the procedure. 


NOTE: 


The use of the dcopy command is fairly restrictive: the 


copy must be made to another file system of the same 
size. That is, you must have another disk of the same 
size (which is unused). 


The general procedure for a non-root file system is: 


ae 


Enter single-user mode and unmount the file system to be 
copied. 


Execute fsck on the file system to assure correctness. 


Copy the file system to a spare disk drive using 
/etc/volcopy. 


Copy the file system back to the original drive using dcopy. 
Execute fsck on the file system to assure correctness. 


Enter multiuser mode. 
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The general procedure for a root file system is: 

1. Create a special kernel which specifies the root device as 
the spare drive to which the root file system is to be copied. 
Be sure to save the original kernel. 

2. Create a cf file with the appropriate entry for the root 
device and relink the kernel. See Chapter 1 for more 
information. 

3. Enter single-user mode. 


4. Execute fsck on the root file system to assure correctness. 


5. Copy the root file system to the spare disk using 
/etc/volcopy. 


6. Reboot the system, using the kernel created in Step 1. 

7. Copy the file system back to the original disk using dcopy. 
8. Reboot the system, using the original kernel. 

9. Execute fsck on the root file system to assure correctness. 


10. Enter multiuser mode. 


Directory Organization 
Directories retain the largest size they have ever achieved. 


When a file is removed from a directory, the inode number 
recorded in its directory entry is changed to zero. This leaves an 
unused entry of 16 bytes. Removing many files from a directory, 
without creating other files, can result in many unused entries. 


During the search of a directory, all blocks of the directory are 
searched until the file is found. If a directory has 200 files in it and 
the first 199 files are removed, an Is for this directory requires 4 
I/O operations (3 for the empty directory blocks and 1 for the 
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block with the file entry). 


One of the functions of the dcopy command is to remove unused 
entries from directories. 


The procedure in the following section may be used to remove the 
unused entries from a single directory. This should be done 


periodically to any directory which has many files created and 
removed, and is also searched often. 


Shrinking a Single Directory 


The following procedure may be used to remove unused entries 
from a single directory. 


1. Move the directory you need to shrink to a new name. For 
example, 


mv /usr/acct/student1/bin /tmp/temp.dir 
2. Recreate the directory to be shrunk. For example, 
mkdir /usr/acct/student1/bin 


3. Change your current directory to the temporary directory 
you created in Step 1 and copy the files back. For example, 


cd /tmp/temp.dir 
find . -print | cpio -pdimuv /usr/acct/student1/bin 


4. Remove all files from the temporary directory and then 
remove that directory. For example, 


cd /tmp/temp.dir 
rm -r * 

cd 

rmdir /tmp/temp.dir 
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I/O Balancing 


If a system has multiple disk drives, the files should be distributed 
across the disks so that each drive performs an equal share of 
work, 


File system distribution is done by mounting a disk on a directory. 
By default, each disk contains a single file system. 


A disk may be divided into several file systems by partitioning the 
disk. A separate file system may be placed on each partition of 
the disk. See the following section, "Disk Partitioning," for 
information on partitioning a disk. 


If possible, directories that are changed frequently (have many 
files created and removed) should not be on the root file system 
(user directories, /tmp, and so on). This is so that the free block 
list for the root file system does not become disorganized because 
of these directories. 


Since the purpose of the /tmp directory is to have users create 
and remove temporary files, you may consider having a separate 
file system for /tmp (this may be a partition of a disk, rather than 
an entire disk). This reduces the disorganization in the root file 
system. Approximately 5,000 blocks is a good starting size for the 
/tmp file system. 


NOTE: 


During a backup using the sa menus, a separate tape 
is required for each file system. 


Disk Partitioning 


Hard disks may be partitioned to contain more than one file 
system. 
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Each hard disk has 16 partitions. Their uses are as follows: 


0 The entire disk, including the Intermediate System 
Loader, Bad Block Area, and Maintenance Cylinder. 


1 The default file system partition. This may be modified. 
2-12 Additional file system partitions. These may be 
modified. 


13-14 Used by the INSTALL media for a file system and swap 
area. These may NOT be changed. 


15 The swap area. This may be changed if the size of the 
swap area is changed (see Chapter 2). 


The dkpart command displays and/or changes the current 
partitions for a disk. Partition specification includes the size (in 
physical blocks) and the physical block offset from the beginning 
of the disk. 


To display the current partitions for a disk, use the following 
command: 


/etc/dkpart -d device 


Partitioning of the root device is not supported except during 
installation on 5000/30/35/50/55 Release 2.00. 


Changing Partitions (5000/20/30/40/50 Releases Prior to 2.00) 
If backing up existing files, the backup must be an incremental 


backup (using cpio), not a full system backup (using volcopy). 
This is because volcopy retains the original size of the file system. 
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NOTE: 


For the following examples, when device is specified, 
refer to Table 2-6 "Root Devices." 


1. If the disk device has not been added to the system, it must 
be added using the sa menus (Add a Device). 


Be sure that the disk is formatted and that all bad blocks 
are entered (marked). Do not distribute any files to the 
disk; answer n when asked the question about automatically 
assigning files to the disk. 

2. If the disk already contains files, backup those files. 


3. Determine the number of blocks for each partition. 


4. Create the character and block special files (device nodes) 
for each new partition using the /etc/mknod command. 


5. Change the partition sizes and starting locations as follows: 

a. Create a file, /tmp/file, for this example. This file 
should have the sizes and block offsets for each 
partition of the disk, one partition per line. 
Partition O must have a size of 0 and a starting offset 
of 0. In addition, be sure that the file system 
partitions do not overlap. The starting block for one 
partition must not be part of another partition. 

b. /etc/dkpart-p device </tmp/file 

c. /etc/dkpart -d device 


d. Check the sizes and starting locations for errors. 
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e. Create a file system on each partition. 


6. Create entries in the file /etc/mntnodes for each partition. 


These entries should be in the form: 
device directory 


This file describes the file systems to be mounted when 
entering multiuser mode. 


Create entries in the file /etc/checklist for each partition. 
There should be one file system listed per line, and this 
should be the character device name for the partition. This 
file describes the file systems to be checked when entering 
multiuser mode. 


Mount each file system under the directory /mnt and 
distribute the files. The general procedure is: 


a. /etc/mount device /mnt 

b. cd directory-to-copy 

c. find . -print | cpio -pdimuv /mnt 
d. cd /mnt 

e. /etc/mklost+ found 

{.. cd 

g. /etc/umount device 

h. ed directory-to-copy 

i rm-r * 


Repeat this procedure for each partition. 
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9. Enter multiuser mode and make sure that all file systems 
are automatically mounted, checked by fsck, etc. 


Changing Partitions (5000/30/35/50/55 Release 2.00) 


If backing up existing files, the backup must be an incremental 
backup (using cpio), not a full system backup (using volcopy). 
This is because volcopy retains the original size of the file system. 


1. If the disk to be partitioned currently contains files, backup 
those files incrementally. 


2. Use the sa menus to configure the device. If the device has 
not been added, you must add it as well as partition it. 
Otherwise, you may just partition it. 


3. Use the partitioning menu to set up the sizes for each 
partition, as desired. 


NOTE: 


Partition 15 should NOT be used for a file system. 


4. Use the sa menus to move a directory to the new partitions. 
This creates the file systems, appropriate entries in 
/etc/mntnodes and /etc/checklist, and moves the files. 


5. If the disk previously contained files that were backed up in 
Step 1, restore the files. 


6. Enter multiuser mode to make sure that the file systems are 
checked by fsck and mounted correctly. 
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NOTE: 


The root device may only be partitioned during 
installation. Follow the same general procedure as 
described for increasing the swap space in Chapter 2, 
"Use of Memory." 


Backup/Restore - Partitioned System 


A normal backup and restore of a file system using the sa menus 
does not support partitioning of disks. The additional manual 
procedures are described in the following sections. 


As Part of System Backup 


The following steps should be performed by the superuser just 
before performing a full system backup: 


1. Create a file with the disk partitioning information for each 
disk. The following procedure may be used: 


a. cd /dev/rdsk 
b. foriin *so0 
do 
/etc/dkpart -d /dev/rdsk/$i >/sys/partinfo.$i 
done 


2. Copy the partition information files to a tape. The following 
procedure may be used. You may also want to print a copy 
of these files for reference. 


a. cd/sys 
b. Is partinfo* | cpio -ocv | dd of =/dev/rmt/device 


In this example, use the appropriate device name for 
the magnetic tape or use /dev/rtp for cartridge tape. 
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3. 


4, 


Label the tape containing the partition information as 
follows, and store it with the system backup tapes. 


System Name: Date: 
Contents: System Backup 
System Partition Information 


Perform the full system backup, as normal. 


During Full System Restore of the Root Device 


3-14 


Boot the system from the INSTALL tape, as for a normal full 
system restore. 


At the first menu, select File System Maintenance. 


Copy in the contents of the system partition information 
tape, using the following procedure: 


a. Insert the System Partition Information tape in the 
tape drive. 


b. cd /sys 

c. dd if=/dev/tape | cpio -icv 

d. Remove the tape from the drive. 
Compare the starting locations and sizes for partitions 13, 
14, and 15 in the output of the following command, using 
the appropriate partinfo file for the root partition. If any of 
them are different, the restore procedure must be restarted 


after the partitioning is restored. 


/etc/dkpart -d /dev/rdsk/root 
cat /sys/partinfo.cndms0O 
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where: 


n = controller number 
m = disk device number 


Partition the root device, using the following command: 
/etc/dkpart -p /dev/rdsk/root </sys/partinfo.cndmsO 


where: 
n = controller number 
m = disk device number 


Use the partinfo file for the root device. 


Reset the system if Step 4 determined that the restore 
procedure must be restarted OR exit file system 
maintenance (enter < Ctrl > d). 


Select the appropriate restore selection from the installation 
menu and complete the restore of the root file system. 


During Restore of All Other File Systems 


Perform the following while logged in as the superuser, BEFORE 
continuing the Full System Restore. 


is 


Ps 


cd /sys 


Perform the following command for each disk, except the 
root disk: 


/etc/dkpart -p /dev/rdsk/cndms0O < /sys/partinfo.cndmso 


where: 


n = controller number 
m = disk device number 
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3. Log off and log in as sa. Continue the system restore 
procedure, as normal. 
Automatic Sync Feature 


The 5000 Series operating system keeps copies of the following 
disk structures in memory for fast access: 


1. superblocks of all mounted file systems (including the root 
file system), 


2. inodes of all active inodes (in the Active Inode Table), 

3. data blocks being referenced (in the System Buffer Area). 
These disk structures are updated on disk periodically. This 
periodic update is called the automatic sync feature because the 
same function is performed by the syne system call. 

The default frequency of the automatic sync is every 5 minutes. 
To change this frequency, add the following entry to the file 
/etc/inittab: 


it :: syncint :/n 


where rn is in seconds and must be in the range 15-900 (15 
seconds to 15 minutes). 


Increasing the frequency of the automatic sync does not 
drastically affect system performance. 


Decreasing the frequency of the automatic sync increases the risk 
of file system corruption in the event of a system failure. 


Summary 


The following procedure summarizes the different steps you may 
take to improve disk use: 
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1. Optimize the file systems using /etce/dcopy. 


2. If Step 1 was not performed, reorganize the free block list of 
each file system so that new files are more efficiently 
spaced on the disk. (Use /etc/fsck -s). 


3. If Step 1 was not performed, reorganize large directories to 
remove unused entries. The procedure is specified in the 
text of this chapter. Use the following command to locate 
directories which are larger than 2 physical blocks: 


find / -type d -size +2 -print 
4. If the system has more than one disk, analyze disk activity 


(see Chapter 5). If use of the disks is uneven, consider 
redistributing the file systems and/or partitioning the disks. 


NOTE: 


Turn to Chapter 7 and perform Exercise 3, "Use of 
Disk." 
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Chapter 4. 
Load Manipulation 


The CPU must be used efficiently to gain maximum system 
performance. Though the speed of the CPU cannot be changed, 
the load on the CPU (the amount of work it is requested to do) 
can. 


The ideal situation is for the load on the CPU to be even 
throughout the day. This is normally not practical; some periods 
during the day are busier than others. 


The load during the peak time--the time of heaviest load--is the 
load which should be minimized as much as possible. The 
following items should be checked to reduce the load during peak 
time: 


1. Less important processes interfering with more important 
processes. The less important processes (jobs) should be 
rescheduled to run during a time of lower load. 


2. Unnecessary processes being run. These processes should 
be eliminated from the system, or restricted during peak 
times. 


3. Scheduling jobs when the system is not so busy. 


4. The efficiency of user-defined features, such as .profile and 
the PATH variable. 


Another factor that can affect the "feel" of system performance is 
modification of the time slice. See the description of the tslice 
configuration parameter in Chapter 1, "System Reconfiguration," 
for more information. 
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PATH Variable 


The directories in the PATH variable are searched for each 
command execution. Before outputting the message not found, 
the system must search all directories in the PATH. If there is a 
disk or processor bottleneck, changes in the PATH variable can 
help performance. 


Check the following characteristics of the PATH variable: 


1. 


Path efficiency: The PATH variable is read left to right, so 
the most likely places to find a command should be first in 
the path. Make sure that a directory is not searched more 
than once. 


Convenience and Human Factors: Users may prefer to 
have the current directory listed first, even though it is not 
the most common location for commands. 


Path Length: In general, the PATH variable should have 
the least number of entries as possible so that infrequently 
used directories are not searched for every command. 


Large Directory Searches: The searching of large 
directories should be avoided if possible. Large directories 
should be placed at the end of the path so that they are 
only searched if necessary. 


To change the PATH variable for all users, change the following 
line in the /etc/profile file: 


PATH = /usr/ucb:/bin:/usr/bin: 
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NOTE: 


The /usr/ucb directory should be searched before the 
bin directory. This is because both directories contain 
an Is command; but the one in /usr/ucb is the one 
most commonly used. 


Miscellaneous Factors 


System Misuse 


System misuse (many processes for a single user, etc.) should be 
detected. The System Accounting utilities can be used to detect 
system misuse. 


Time Slice 


Modification of the time slice for processes can change the user's 
perception of system response time. The time slice is the 
maximum amount of time a process may execute without being 
interrupted (a process may be interrupted by other system activity 
before its time slice is over). 


The time slice may be modified using the tslice system call or by 
setting the tslice configuration parameter. The valid range is .01 
seconds to 54 seconds (default is 1 second). 


See the description of the tslice configuration parameter in 
Chapter 1, "System Reconfiguration," for more information. 
Decreasing the time slice assures that more processes get a 
chance at the CPU, but increases the system overhead for 
switching between processes. Experimentation with response time 
using different time slices is the best method for determining if the 
time slice should be changed. 
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Synchronous Writes 


A tool available to users for increasing the accuracy of data is 
synchronous writes; the process waits for the actual I/O to occur 
before returning, rather than letting the system determine the 
most efficient time for the I/O. 


Synchronous writes are selected in two different ways: 


- by letting the O_SYNC flag on the open system call so that 
all writes to the file are performed synchronously, and 


- by using the swrite system call for each write request. 
If many users are performing synchronous writes, system 
performance can be affected. If this occurs, check to make sure 


that all processes performing synchronous writes actually need 
that feature. 


NOTE: 


A synchronous write using the swrite system call 
flushes only the buffers associated with this write. 


Buffers associated with previous writes are not flushed. 
Mixing normal writes and synchronous writes can 
affect file integrity in the event of a system failure. 


Use of Relative Pathnames 


When a full pathname (one starting with /) is used, the system 
must search all directories in the path to locate the file. If the 
current directory is changed and a relative pathname is used, the 
system only has to search the directories below the current 
directory in the hierarchy. 


Therefore, use of relative pathnames can decrease the amount of 
pathname searching that the system must perform. This can help 
reduce the load during peak times. 
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NOTE: 


Turn to Chapter 7 and perform Exercise 4, "Load 
Manipulation." 
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Testing Tools 


Introduction 


Changes made to enhance system performance must be tested to 
measure the effects on the system. In general, the best method 
to test system performance is to take "snapshots" of the system 


over a period of time. 


For example, taking a snapshot of the 


activity for a five-minute period once an hour for four hours. This 
provides a more accurate picture of performance than a single 
snapshot, since the activity on the system varies during the day. 


There are three categories of tools which can be used to test 


system performance: 


Internal System Activity 


Process Accounting 


Program Behavior 
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The measuring of kernel activity, such 
as the efficiency of the System Buffer 
Area, overflows in system tables, etc. 
This is done with the sar command. 


The measuring of user process 
activity, such as line use, user 
resource access, and command use. 
This is done by System Accounting 
utilities. 


The profiling of the execution of a 
program to identify the parts of the 
program which account for most of 
the execution time. These areas may 
be optimized to improve the 
performance of the program. 
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sar — Internal System Activity 


The sar command reports on the internal system activity that has 
occurred over a specified time interval. This internal system 
activity includes: 


- CPU use, 

- System Buffer Area activity, 

- terminal activity, 

- swapping and switching activity, 

- queue activity (Run and Swap queues), and 

- System Table use and overflows (Process, Text, Active Inode, 

and System Open File). 

The sar command should normally be executed in the 
background, with the output redirected to a file for later study. In 
addition, it is best to use the sar command to take several 


samples of system activity before coming to any conclusions, 
since the activity on the system varies from moment to moment. 


sar Format 

The general format of the sar command is: 
sar [options] time [num] 

where: 


options _ is an optional field, specifying the activity to sample. If 
omitted, the -u option is assumed. 


-U reports CPU use (default). 
-b reports System Buffer Area activity. 
-y reports terminal activity. 


-wW reports swapping and switching activity. 
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-q reports Run Queue and Swap Queue activity. 
-V reports system table use and overflows. 


time is a required field (for this type of use). This is the 
number of seconds to sample activity. For example, a 
value of 60 samples the system activity during a 60- 
second time period. 


num is an optional field. If omitted, 1 is assumed. This is 
the number of samples to take. 


The output for each of the previous options is described in detail 
on the following sections. 


NOTE: 


See sar(1) in the User Reference Manual for 
information on additional options and more details on 
the format. 


See sar(1M) in the Administration Reference Manual 
for information on how the sar command may be set 
up to execute automatically. 


More than one option may be specified at one time. 
The output is difficult to understand, however, because 
all of the headers are displayed first, then the lines of 
output for each option specified. 
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CPU Use: sar -u 


Description 


The sar -u command measures the use of the CPU. The CPU is 
either busy (executing code) or idle (inactive). 


If the CPU is busy, it is executing either user code (from a 
process) or system code (from the kernel). Remember that all the 
device drivers and system calls are in the kernel code. 


If the CPU is idle, it is either waiting for 1/0 to complete or has 
nothing to do (truly idle). 


Output Fields 


%SyS Percent of the time the CPU executed in system mode 
%usr Percent of the time the CPU executed in user mode 
%wid Percent of the time the CPU was idle, but waiting for 


I/O to complete 


%idle Percent of the time the CPU was idle 


Interpretation 

In typical timesharing use, %sys and Y%usr are approximately the 
same value. In certain applications, either of these may be larger 
than the other without anything being abnormal. 

The following are indications of a problem in CPU use: 

%wio > 7 ~ Indicates a potential disk bottleneck. The file system 


distribution should be checked to balance I/O across 
disks. 
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%idle < 10 Indicates that the system is having trouble keeping 
up with the load. If this occurs consistently, reduce 
the system load or spread activity over more than 
one system. 
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System Buffer Activity: sar -b 


Description 


The sar -b command measures the efficiency of the System Buffer 
Area. 


The System Buffer Area is a reserved area of memory which 
stores blocks from file systems to minimize the actual I/O which 
must occur to read and write files. The efficiency of the buffer 
area is determined by the percent of the time the system can 
avoid I/O because the data blocks required are already in the 
buffer area. 


If the percentage is high, then the System Buffer Area is being 


used efficiently. If the percentage is low, then the System Buffer 
Area is not being used to its full potential. 


Output Fields 
bread/s Average number of physical blocks read per second 
(actual I/O) 


lread/s Average number of logical blocks read per second 
(number of read requests) 


%rcache Fraction of logical read requests for which the block 
was found in the buffer area (thus avoiding the physical 
I/O) 


bwrit/s Average number of physical blocks written per second 
(actual I/O) 


Iwrit/s Average number of logical blocks written per second 
(number of write requests) 
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%wceache Fraction of logical write requests for which the write was 
performed in the buffer area (thus avoiding the physical 
I/O) 


pread/s Average number of physical (raw) I/O read requests per 
second (bypassing the buffer area) 


pwrit/s | Average number of physical (raw) I/O write requests per 
second (bypassing the buffer area) 


Interpretation 


The values which indicate the efficiency of the buffer area are 
%rcache and %wcache. The higher the value in each of these 
fields, the more efficient the buffer area is. 


The following are indications of a potential problem with the 
efficiency of the System Buffer Area: 


%rcache < 90 
$weache < 80 


In either case, it may be possible to improve performance by 
increasing the size of the buffer area. This may increase the 
amount of swapping, however, which adversely affects 
performance. 
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Swapping and Switching Activity: sar -w 


Description 


The sar -w command measures the amount of actual swapping 
and switching activity. 


The swap area is used to provide secondary memory when there 
is not enough room in memory for all processes on the system. If 
excessive swapping occurs, system performance is degraded since 
the process must be loaded into system memory before it can be 
executed. 


The system switches between processes when it allocates the CPU 
to another process. Excessive switching activity degrades system 
performance because the overhead for the switching itself is 
increased, which means the CPU is spending less time executing 
user processes. 


Output Fields 


swpin/s Average number of transfer requests into memory per 
second 


bswin/s Average number of physical (512-byte) blocks 
transferred into memory per second (includes the initial 
loading of programs) 


swpot/s Average number of transfer requests from memory to 
the swap area per second. At system start-up, swpot/s 
may be larger than swpin/s due to the loading of sticky 
bit programs. 


bswot/s Average number of physical (512-byte) blocks 
transferred from memory to the swap area per second 
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pswch/s Average number of process switches per second 


Interpretation 

Since swpin/s also includes the initial loading of programs, swpot/s 
provides a better measure of the amount of swapping activity on 
the system. 


The average number of process switches per second should be 
10-30 on a 10-user system. 


The following indicates excessive swapping activity: 
swpot/s > 1.0 The amount of system memory should be 


increased or the size of the System Buffer 
area should be decreased. 
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Queue Activity: sar -q 


Description 


The sar -q command measures the use of the Run (READY) 
Queue and the Swap Queue. 


The Run Queue is a list of all processes which are ready to 
execute and are waiting for the CPU. 


The Swap Queue is a list of all processes which are swapped out 
(in the swap area) but are ready to execute. 


Output Fields 
runq-sz Average number of processes in the Run Queue per 
second 


Yrunocce Percent of the time that the Run Queue was occupied 
(at least 1 process) 


swpq-sz Average number of processes in the Swap Queue per 
second 


Yswpocc Percent of the time that the Swap Queue was occupied 
(at least 1 process) 


The %runocc field currently does not report a valid percentage, 
and should be ignored. 


Interpretation 
The following indicate a problem with the queues: 


%runocc > 90 and 

rung-sz > 2 This indicates that the CPU is heavily 
loaded and the response time for users is 
degraded. If this occurs consistently, 
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reduce the system load or spread activity 
over more than one system. 
co 

%Sswpoce > 10 This indicates that excessive swapping is 
occurring. If this occurs consistently, the 
amount of system memory should be 
increased or the size of the System 
Buffer Area should be decreased. 
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System Table Activity: sar -v 


Description 


The sar -v command reports the use and any overflows of the 
system tables listed as follows. 


Text Table Keeps track of shared text 
Process Table Keeps track of processes 
Active Inode Table Keeps track of inodes (files) in use 


System Open File Table Keeps track of open files 


The sizes of these tables are determined by the system 
configuration parameters set when the kernel was created. If any 
of these tables become full, an error occurs (this is referred to as 
an overflow of the table). If any of the tables are under-used, 
memory may be saved by decreasing their size. 


Output Fields 
text-Sz The number of entries in use at the time of the sample 
and the total size of the Text Table 


proc-sz The number of entries in use at the time of the sample 
and the total size of the Process Table 


inod-sz The number of entries in use at the time of the sample 
and the total size of the Active Inode Table 


file-sz The number of entries in use at the time of the sample 
and the total size of the System Open File Table 


text-Ov The number of overflows in the Text Table since the last 
sample was taken 
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proc-ov The number of overflows in the Process Table since the 
last sample was taken 


inod-ov The number of overflows in the Active Inode Table since 
the last sample was taken 


file-ov The number of overflows in the System Open File Table 
since the last sample was taken 


Interpretation 


If any of the system tables overflow consistently, their size should 
be increased. 


If any of the tables are consistently using less entries than the size 
of the table, the size of the table may be decreased to save 
memory. 
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Process Accounting 


The Process Accounting utilities can be used to determine user 
and process activity on the system. This can be helpful in 
identifying heavy load times and system misuse. 


See the Administration Guide for a complete description of all the 
Process Accounting utilities. 


The accounting file used for determining system activity is 
/usr/adm/acct/sum/rprtmmdd (where mmdd is the month and 
day). The report is divided into 6 parts: 


From/To Banner Indicates the report period, records 
system reboots, shutdowns, and 
power fail recoveries. 


Line Use A breakdown of line use. If #OFF is 
over 4 times greater than #ON, there 
may be line problems. Also check for 
unused lines that may have modem or 
line problems. The TOTAL 
DURATION field identifies the amount 
of time the system was in multiuser 
mode so that the lines could be used. 
If this time is short, the line statistics 
(#ON, #OFF, etc.) may not be 
significant. 


Daily Usage Report A report of system use by user. A 
user with a large value for # OF 
PROCS may have a shell process 
which is in an infinite loop. Also look 
for users with large CPU and disk 
block usage. 


Daily Command Summary The number of times commands were 
called daily. Consider relinking the 25 
most used commands as shared text. 
If they are shared text, consider 
setting the sticky bit for those 
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commands. Commands with a high 
REAL-MIN value don’t need the sticky 
bit set since they are usually in 
memory anyway. Check for excessive 
CPU use by games or other non- 
Critical activity. 


Monthly Total Summary Same _ as_ the Daily Command 
Summary, except that all reports are 
for the month rather than a single day. 


Last Login Indicates the last times login names 
were used. This helps identify unused 
login names which can be removed. 


Program Behavior 


If a specific program is heavily used on a system, improving the 
performance of the program itself can improve the user’s view of 
overall system performance. The performance of a program may 
be achieved by optimizing, through modification to the source 
code, the routines which are most heavily used in the program. 


Program behavior can be determined by profiling. Profiling 
identifies the paris of a program that account for most of the 
execution time. 


To profile a program: 


1. Compile the program with the -p option of cc 


2. Execute the prof command on the program to identify the 
percentage of total time that was spent in each function and 
how many times each function was called. 


Profiling can be used to identify functions which, if optimized, have 
the most effect on the total performance of the program. 
Frequently called functions may be replaced with in-line code to 
save function call overhead. 


UP-12715 R1 9-15 


Chapter 5 


NOTE: 


Turn to Chapter 7 and perform Exercise 5, "Testing 
Tools." 
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Chapter 6. 
Diagnostic Flow Chart 


Introduction 


This chapter consists of a diagnostic flowchart which is intended to 
help you diagnose system performance problems. The small 
squares in the flowchart list utilities or tools which may be used to 
check system performance. The diamonds represent questions; if 
this result occurs, follow the arrow to the list of possible actions. 
The flowchart is followed by a more complete explanation of each 
symptom and possible action. 


The most common cause of poor performance is listed first, the 
second most common cause second, etc. If you do not know 
what is causing poor performance, go through the flowchart in 
order. If you feel you know what is causing the problem, enter the 
flowchart at the appropriate point (A, B, C, etc.). 


These are guidelines only; there are no guaranteed solutions. 
Here is the order of the flowchart: 


A. Excessive Swapping 
Inefficient Disk Usage 
Excessive Device Interrupts 
CPU Overload 

Demand Paging Overload 
Table Overflows 


Empty Blocks in Directories 


ss Sa? a <9 


User Misuse 
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(a) Excessive Swapping 


Add more memory 
Use shared text 


Reduce # of buffers 


Add demand paging 


SW POCC 
* 10 


N 
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Disk Usage 
Inefficient 


Set sticky bits 


Balance disk load 


Create separate file 
system for /tmp 


a Increase # buffers 


Optimize with dcopy 


Add disk device 


%rcache 
| 
%*wecache 


< 80 
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Excessive 
Device Interrupts 


sar -y 


Se 


Accounting 


Package 


#OFF > 
4x #ON 
N 


Check/repair faulty 


modem, port, 
terminal, or line 
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D } CPU Overload 


Offload activity to 
non-peak hours 


%idle 
< 10 
Offload activity to 
another system 
%runocce 
> 90 
N 
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(E ) Demand Paging Overload | 
WwW 
‘ Increase time slice 
Sys Remove Demand 
Paging 
N 
(F Table Overflows 
Ww 
Increase size 
suere lows? of tables 
which overflowed 
N 
WwW 
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Empty Blocks in Directories 


See findligdir 
shellscript 


Reduce directory size 


dir. with 
wasted blks? 


Optimize with dcopy 
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CH) User Misuse 


Accounting 


Package 


#PROCS big 
or games? 


%wcecache 
< 80 


N 
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Educate users 


Limit non-essential 
activity to non- 


peak hours 


Limit use of 
synchronous writes 


UP-12715 R1 


Diagnostic Flow Chart 


SN RR NT BNE SG SM 


Explanation of Diagnostic Flowchart 


A. Excessive Swapping 

Excessive swapping is the primary cause of poor system 
performance and should be checked first. Swapping is costly in 
both disk and CPU overhead. 


Several different methods can be used to detect excessive 
swapping: 


Sar -w swpot/s consistently > 1.0 
sar -q %swpocc consistently > 10 
Some possible actions to reduce the amount of swapping are: 
1. Increase the amount of system memory. 
2. Relink frequently used programs into shared text. 
3. If a large number of buffers have been configured, decrease 


the value of the buffers configuration parameter, (and 
hashbuf, if necessary). 


B. Disk Usage 
Poor system performance can also be caused by poor disk usage. 
This may be a result of poor I/O balancing, inefficient use of the 


System Buffer Area, poor block distribution for files, etc. 


Several different methods may be used to detect disk usage 
problems: 


Sar -u %wio consistently > 7 


sar -b %rcache consistently < 90 and/or 
%wcache consistently < 80 
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Some possible actions to improve disk usage are: 


1. Increase the size of the System Buffer Area (buffers 
configuration parameter). 


2. Set the sticky bit for frequently-used shared text files. 


3. Move files from a busy disk to a less busy disk (balance the 
load). 


4. Create a separate file system for /tmp. 
5. Optimize file systems with dcopy. 


6. Add additional disks. 


C. Device Interrupts 

Excessive device interrupts can affect system performance 
because the system spends time trying to process interrupts. 
These are normally caused by a faulty modem, port, terminal, or 
line. 


There are several methods for detecting excessive device 
interrupts: 


Sar -y mdmin/s not equal to 0 


Accounting The accounting report showing that #OFF is 
more than 4 times greater than #ON for a line 


D. CPU Overload 


System performance can also be affected by the overloading of 
the CPU. The processor can only handle a certain amount of work 
before becoming overloaded. 
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There are several methods for detecting CPU overload: 


Sar -u %idle consistently < 10 
Sar -q %runoce consistently > 90 and rung-sz consistently 
oe a 


There are two actions which can reduce the CPU load: 


1. Shift activity to non-peak times (check /usr/spool/crontab, 
non-interactive commands, etc.). 


2. Shift activity to another system. 


E. Demand Paging Overload 

If a demand paging system is overloaded and most of the time 
slice for a process is spent bringing its pages into memory, system 
performance is severely degraded. 


Demand paging overload may be detected by: 


Sar -u %sys close to 100 and extremely poor response. 
Excessive swapping is probably occurring. 


There are several actions which may help this problem: 
1. Increase the time slice (tslice configuration parameter). 


2. Remove demand paging (if possible). 


NOTE: 


5000/30/35/50/55 systems must have demand paging. 
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F. Table Overflows 

The system cannot perform effectively if any of the system tables 
(Text Table, Process Table, Active Inode Table, and System Open 
File Table) run out of entries. This situation generates an error 
(see the configuration parameter descriptions in Chapter 1). 


The overflow of a system table may be detected by: 


Sar -v Any of the -ov fields being non-zero (indicates an 
overflow has occurred in the table). 


To eliminate table overflows: 


1. Reconfigure the system with the appropriate configuration 
parameter increased. 


G. Empty Blocks in Directories 


Directories retain the largest size they have ever achieved. If a 
directory contains many empty entries, searches of that directory 
Cause unneeded disk accesses (reading the blocks with empty 
entries). 


The following shellscript is an example which detects directories 
with at least one wasted logical block: 
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# findigdir -- Lists all directories with at least one 
# wasted block due to empty file slots 
# usage: findigdir 
find / -type d -size +2 -print >/tmp/lgdirSss 
for i in ‘cat /tmp/lgdir$s‘* 
do 
# Determine actual number of entries in directory 
set ‘Is -ld Si‘ 
size=$4 
space=‘expr $4 / 16° 
# Determine number of non-deleted entries in directory 
entries=‘Is -la $i {| we -1° 
# Subtract line giving Total for directory 
entries=‘expr Sentries - 1° 
# Compare actual number of entries to number in use 
diff=‘expr Sspace - Sentries‘ 
# Calculate number of wasted blocks (64 entries per block) 
blk=‘expr Sdiff / 64° 
if [ Sb1k -ge 1 ] 
then 
echo $i has $b1k wasted blocks iff empty slots) 
fi 
done 


The following methods may be used to eliminate wasted blocks in 
directories: 


1. Reduce the size of a directory by copying its files to another 
directory, removing the original directory, recreating the 
directory, and copying the files back. See Chapter 3, "Use 
of Disks," for more information. 


2. Optimize the file system using dcopy. 


H. User Misuse 


Misuse of the system by users can affect system performance. 
Misuse includes the running of non-essential programs, running an 
excessive number of processes, and overusing the synchronous 
write feature. 
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The following may be used to detect user misuse: 


Accounting The accounting report showing a large value for 
# OF PROCS for a particular user. Also, 
showing non-essential programs run during peak 
times. 


sar -b Writing to the buffer area showing inefficiency (< 
80), but the reading of the buffer area showing 
efficiency. 


The following methods may be used to help limit user misuse of 
the system: 


1. Educate the users to the importance of not abusing system 
resources. 


2. Limiting non-essential activity (games, etc.) to non-peak 
hours. 


3. Limiting the use of synchronous writes when they are not 
necessary for the application. 


Summary 


If none of the tuning procedures solve performance problems, the 
system may simply be overloaded. If excessive swapping is still 
slowing performance, more memory should be purchased. If the 
system use during peak time is still near 100 percent, it may be 
necessary to offload work to another system. 
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Chapter 7. 
Exercises 


Exercise 1: System Reconfiguration 


Kernel Reconfiguration 


1. Change your current directory to /kernel/sperry/cf and 
copy the file 5.2.cf to test.cf. 


2. Edit test.cf to change the following parameters to the 
values recommended for your system in the configuration 
parameter descriptions in Chapter 1: 

- buffers 
- clists 
- hashbuf 

3. Follow the procedure described in Chapter 1 to create a 
new kernel using your new cf file. Test this kernel to make 
sure that all processes still work correctly. 

Be sure that you save the original kernel in case the new 
kernel does not work. Also, do not reboot the system if 
other users are active. 

4. After the testing is complete and you are satisfied that the 


new kernel works correctly, copy /kernel/sperry/cf/test.cf 
to /kernel/sperry/cf/5.2.cf and /sys/cf. 
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Inter-Process Communication 


1. An application is to be added to the system which uses 
shared memory and semaphores. Describe the changes 
you MUST make to the kernel for this application to run. 


2. Describe changes you would consider making to the kernel, 
based on the exact usage the application makes of shared 
memory and semaphores. 


Partitioned Disks 


A system has three hard disks. The second and third disks (the 
non-root disks) are to be partitioned into four pieces each. Does 
the kernel need to be changed to permit this partitioning? If so, 
describe the changes needed. If not, explain why not. 
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Too Many Processes 


A user complains that the message fork failed: too many 
processes is displayed when they try to run a recursive shellscript 
they have written. No other users notice a problem. Does the 
kernel need to be modified to fix this problem? If so, describe the 
changes needed. If not, explain why not. 


Exercise 2: Use of Memory 


Kernel Size Estimation 


Estimate the physical and logical kernel size for a 5000/40 system 
with the following characteristics: 


- Demand paging 

- buffers - 80 

- clists - 250 

- shared memory 

- semaphores 

+ 5.25" Disk 

- 5.25" Tape 

- HPSIO - 2 boards 
- SNA 
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Estimation of Memory Requirements 


Estimate the total memory requirements for a 5000/30 or 5000/50 
system with the following characteristics: 


- SCSI Disk 

- 5.25" Disk 

- 5.25" Tape 

- 3 HPSIO boards 

- 20 terminals at 9600 baud 

- Average of 15 terminals logged in 

- 10 terminals run a combination of vi and cc 
- 5 terminals run a 100K COBOL application 


Assume that the COBOL application is non-shared. 


Determining the Amount of Free Swap Space 
Using the procedure described in the "Increasing Swap Space" 


section of Chapter 2, determine the number of physical blocks 
available in the swap area for your system. 


Increasing Swap Space 


List at least one reason why swap space might need to be 
increased. 
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Exercise 3: Use of Disk 


Reorganization of Free Block List 


Execute /etc/fsck -s for each file system on your system. 


Optimization of Root File System 
List the exact commands required to optimize the root file system. 


Assume that the root file system is on the top 5.25" disk (46MB) 
and the bottom 5.25" disk (46MB) is an extra disk. 


Reorganizing /tmp 


1. Check the size of the /tmp directory using the command: 
Is -ld /tmp 


Divide the value in the size field by 16 to determine the 
number of entries in the directory. 


2. Execute the command: 
Is -la /tmp | we -l 


Subtract 1 from the number listed. This is the number of 
entries in use in the /tmp directory. 
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3. If the difference between the result of Steps 1 and 2 is more 
than 10, perform the procedure to shrink the /tmp directory. 


Disk Partitioning 


List the exact commands required to partition a second 5.25" disk 
(46MB) as follows: 


/usr/acct Partition 1: 68187 blocks 
/tmp Partition 2: 8092 blocks 


The swap area is not required on a second disk, so the space may 
be used for file system partitions. 


Exercise 4: Load Manipulation 


PATH Variable 
The /bin and /usr/bin directories are both larger than one block. 


Suggest a method to reduce the average number of I/O requests 
necessary for command searches of the PATH variable. 
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Load Manipulation During Peak Time 
A system performs well except for the peak period of 2-4 p.m. 


List several steps you would take to try to improve the 
performance during the peak time. 


Exercise 5: Testing Tools 


Efficiency of the System Buffer Area 


1. Use the sar command to look at the efficiency of the 
System Buffer Area for a 5-minute time period. Repeat 
once per hour for several hours. 


2. Look at the results of Step 1. Is the System Buffer Area 
being used effectively? If not, what should you do? 


Swapping Activity 


1. Use the sar command to check the swapping activity for a 
5-minute time period. Repeat once per hour for several 
hours. 
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Look at the results of Step 1. Is swapping activity (the 
writing of processes to the swap area) occurring? Is 
excessive swapping occurring? 


If either answer to Step 2 was yes, what should you 
consider doing, if anything? 


System Table Use 


7-8 


Use the sar command to check the usage of the system 
tables for a 5-minute time period. Repeat once per hour for 
several hours. 


Look at the results of Step 1. Are the tables being used 
effectively? Did any overflows occur? 


Based on your answers to Step 2, should the sizes of any of 
the system tables be modified? If so, explain. 
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User Activity 


1. Set up the System Accounting Utilities to execute for one 
day. 


2. Check the results in the file /usr/adm/acct/sum/rprtmmdd 
(mmdd is the current month and day). Are any line 
problems indicated? If so, what should you do? 


3. Are there any users who appear to be abusing the system 
(executing an excessive number of processes, using 
excessive CPU time, or using excessive disk blocks)? If so, 
what should you do? 


4. Look at the top 10 commands executed. Are any of these 
user-created programs? Should any of these programs be 
changed to shared text or optimized? 
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5. Be sure to turn off the accounting package when done, 
since it does take system resources to record this 
information. 
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Appendix A. 
Exercise Solutions 


Exercise 1: System Reconfiguration 


Kernel Reconfiguration 


Change your current directory to /kernel/sperry/cf and 
copy the file 5.2.cf to test.cf. 


Edit test.cf to change the following parameters to the 
values recommended for your system in the configuration 
parameter descriptions in Chapter 1: 


- buffers 

- clists 

- hashbuf 
Follow the procedure described in Chapter 1 to create a 
new kernel using your new cf file. Test this kernel to make 
sure that all processes still work correctly. 
Be sure that you save the original kernel in case the new 
kernel does not work. Also, do not reboot the system if 
other users are active. 
After the testing is complete and you are satisfied that the 
new kernel works correctly, copy the file 
/kernel/sperry/cf/test.cf to /kernel/sperry/cf/5.2.cf and 
/sys/cf. 


Chapter 1 explains this procedure in detail. 
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Inter-Process Communication 


1. An application is to be added to the system which uses 
shared memory and semaphores. Describe the changes 
you MUST make to the kernel for this application to run. 


The shmem and sema configuration parameters must be 
set to 1 in the system file. 


2. Describe changes you would consider making to the kernel, 
based on the exact usage the application makes of shared 
memory and semaphores. 


All of the related configuration parameters for shared 
memory and semaphores should be checked. If the 
intended usage indicates it would be helpful, the values 
should be changed. 


Partitioned Disks 


A system has three hard disks. The second and third disks (the 
non-root disks) are to be partitioned into four pieces each. Does 
the kernel need to be changed to permit this partitioning? If so, 
describe the changes needed. If not, explain why not. 


The kernel would not need to be changed to allow the actual 
partitioning. The following changes, however, might be 
required: 


1. Addition of the driver for the additional disks (if it is not 
the same as the driver for the root device). 


2. Increasing the value of the mounts parameter so that all 
of the partitions may be mounted. 


Too Many Processes 


A user complains that the message fork failed: too many 
processes is displayed when he tries to run a recursive shellscript 
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he has written. No other users notice a problem. Does the kernel 
need to be modified to fix this problem? If so, describe the 
changes needed. If not, explain why not. 


This error is occurring because the user is trying to run more 
processes than the maxproc parameter allows. Most of the 
time, this is more than enough processes for each user. If, 
however, the user has a legitimate requirement to execute 
more than this many processes, then the maxproc parameter 
should be increased. 


Exercise 2: Use of Memory 


Kernel Size Estimation 


Estimate the kernel size for a 5000/40 system with the following 
characteristics: 


- Demand paging 

- buffers - 80 

- clists - 250 

- shared memory 

- semaphores 

« 5.25" DISk 

- 5.25" Tape 

- HPSIO - 2 boards 
> SNA 


Physical Size: 


207K for the base kernel code and structures 
78K for default configuration parameters 
40K for the expansion of the System Buffer Area to 80K 
(from 40K) 
7K for the expansion of c/ists to 250 (from 150) 
4.8K for the shared memory system calls and IPC routines 
2K for the shared memory parameters 
3.8K for the semaphores system calls 
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1K for the semaphore parameters 
16K for the 5.25" disk driver 
12K for the 5.25" tape driver 
18K for the HPSIO terminal driver 
4K for the second HPSIO board 
81K for the MPCA driver (required for SNA) 
41K for the HDLC driver (for SNA) 


515.6K TOTAL 
Logical Address Space: 


192K automatically reserved 
64K 64K reserved for each value of kins (default value of 
1 assumed) 
192K 64K for DMA segments for drivers (3 on this system) 
32K for tape driver 
516K physical size of kernel 


996K TOTAL 


Estimation of Memory Requirements 


Estimate the total memory requirements for a 5000/30 or 5000/50 
system with the following characteristics: 


- SCSI Disk 

- 5.25" Disk 

- 5.25" Tape 

- 3 HPSIO boards 

- 20 terminals at 9600 baud 

- Average of 15 terminals logged in 

- 10 terminals run a combination of vi and cc 
- 5 terminals run a 100K COBOL application 


Kernel Size: 


207K for the base kernel code and structures 
320K for default configuration parameters 
21K for the expansion of clists (from 300 to 600) 
20K for the SCSI disk driver 
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16K for the 5.25" disk driver 
12K for the 5.25" tape driver 
26K for the HPSIO driver and extra boards 


622K TOTAL 


System Processes: 


8K 
51K 
155K 
280K 


swappers 

for /etc/init 

for /etc/getty (average of 5) 
for /bin/sh (average of 10) 
for the three /dhpsio 

for errdemon 

for /etc/cron 


TOTAL 


User Processes 


247K 


47K 


for vi (average of 5 processes; size: 
27K non-shared) 

for cc (average of 3 processes; size: 20K shared, 
9K non-shared) 

for as (executed as part of cc, average of 1 process; 
size: 58K shared, 94K non-shared) 

for /d (executed as part of cc, average of 1 process; 
size: 70K shared, 72K non-shared) 

for COBOL application (average of 5 processes; size: 
100K) 


112K shared, 


TOTAL 


for the kernel 
for system processes 
for user processes 


TOTAL 
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Since the total is more than 2MB, the system should have the 
next available amount of memory, which is 4MB. 


The as and /s commands are executed as a result of a cc 
command. The distribution of user processes between vi and 
cc was arbitrarily selected. 


Determining the Amount of Free Swap Space 


Using the procedure described in Exercise 1, determine the 
number of physical blocks available in the swap area for your 
system. 


For a 5000/20 or 5000/40, inspect the Swap Map Table (using 
the procedure described in Chapter 2) and add up the values of 
all the size fields. 


For a 5000/30/35/50/55, inspect the value of the swapspace 
variable (using the procedure described in Chapter 2) and 
multiply by 64. 


Increasing Swap Space 


List at least one reason why swap space might need to be 
increased. 


Swap space might need to be increased for either of the 
following reasons: 


1. The maximum user address space on a 5000/30/35/50/55 
(the maxspace configuration parameter) was increased 
beyond 10MB. 


2. The system repeatedly either runs out of swap space or 
displays warnings that it is about to run out of swap 


space. 


In this case, a better solution would be to add more 
memory to the system. 
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Exercise 3: Use of Disk 


The device used in examples is available on a 5000/40/50 system 
only. (See Table 2-6, "Root Devices," in Chapter 2.) 


Reorganization of Free Block List 
Execute /etc/fsck -s for each file system on your system. 


This is self-explanatory. 


Optimization of the Root File System 
List the exact commands required to optimize the root file system. 


Assume that the root file system is on the top 5.25" disk (46MB) 
and the bottom 5.25" disk (46MB) is an extra disk. 


1. Make a kernel which specifies the second disk as the 
root device. 
a. cd /kernel/sperry/cf 
b, cp 5.2:cf N502.cf 
c. vihd02.cfs 
change root wd 04 to root wd 05 
change pipe wd 04 to pipe wd 05 
change swap wd 74 1 8000 to swap wd 75 7 8000 
d. /etc/mknod /dev/dsk/cOdisf b 2 61 


e. cd /kernel 


f. make unix VER=h502 REL =xxxx NODE = Unisys 
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Enter single-user mode. 
/etc/single 


Check the root file system. 
/etc/fsck 


Copy the root file system to the bottom disk. 
/etc/volcopy root /dev/rdsk/cOdOs! - /dev/rdsk/cOd1s1 


Reboot using the new kernel. 
a. mv /kernel/sperry/unixh502 /unixh502 
b. sync ; syne 
c. /menu/obj/reboot.o h502 /unixh502 


Optimize the file system 
/etc/dcopy /dev/rdsk/cOd1s1 /dev/dsk/c0d0st1 


Reboot using the original kernel. 
a. sync ; syne 
b. /menu/obj/reboot.o h501 /unix 


Check the root file system. 
/etc/fsck 


Enter multiuser mode. 


Reorganizing /tmp 


A-8 


Check the size of the /tmp directory using the command: 
Is -ld /tmp 


Divide the value in the size field by 16 to determine the 
number of entries in the directory. 
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For example, a size field of 2352 means that 147 entries 
exist in the directory. 


2. Execute the command 
Is -la /tmp | we -l 


Subtract 1 from the number listed. This is the number of 
entries in use in the /tmp directory. 


For example, a value of 12 listed, which means 11 entries 
are actually in use in the directory. 


3. If the difference between the result of Step 1 and 2 is more 
than 10, perform the procedure to shrink the /tmp directory. 


Since the difference is 136, the /tmp directory should be 
shrunk, following the procedure described in Chapter 3. 


Disk Partitioning 


List the exact commands required to partition a second 5.25" disk 
(46MB) as follows: 


/usr/acct Partition 1: 68187 blocks 
/tmp Partition 2: 8092 blocks 


The swap area is not required on a second disk, so the space may 
be used for file system partitions. 


1. Create device nodes. 
a. /etc/mknod /dev/dsk/cOd1s2 6b 2 9 
b. /etc/mknod /dev/rdsk/cOd1s2 c 7 9 
This assumes that the disk was added using the 


menus, which automatically creates the device 
nodes for partitions 0 and 1. 
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c. Create a file which specifies the partitions. 
1) /etc/dkpart -d /dev/rdsk/c0d1s0 
ed 


Record the current values for partitions 13, 
14, and 15. 


2) vi /tmpi/file 


One line per partition, size followed by block offset. 


Partition 0: OO 
Partition 1: 68187 O 
Partition 2: 8092 68187 
Partitions 3-12: 0 0 


Partitions 13, 14, 15: as before 


d. Change partitions. 
/etc/dkpart -p /dev/rdsk/cOd1sO </tmp/file 


2. Check new partitions. 
/etc/dkpart -d /dev/rdsk/c0d1s0 


3. Create a file system on the new partitions. 
letc/newfs -v -s 1 h502 
/etc/newfs -v -s 2 h502 


4. Edit the /etc/mntnodes file to have the following entries: 
/dev/dsk/cOd1s1 /usr/acct 
[dev/dsk/cOd1s2 /tmp 


5. Edit the /etc/checklist file to have the following entries: 
/dev/dsk/cO0d0s1 
/dev/rdsk/cOd1s1 
/dev/rdsk/cO0d 1s2 


6. Copy the files to the new file systems (See Chapter 3 for WwW 
the procedure). 
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7. Enter multiuser mode. 


Exercise 4: Load Manipulation 


PATH Variable 
The /bin and /usr/bin directories are both larger than one block. 
Suggest a method to reduce the average number of I/O requests 
necessary for command searches of the PATH variable. 
1. Split the /bin directory into two directories: 
/bin The 62 most used commands from /bin 


/bin.new All other commands from /bin 


2. Split the /usr/bin directory into two directories: 


/usr/bin The 62 most used commands from 
/usr/bin 
/usr/bin.new All other commands from /usr/bin 


3. Shrink the /bin and /usr/bin directories using the 
procedure described in Chapter 3. 


4. Edit /etc/profile and change the PATH variable to: 


PATH=/usr/ucb:/bin:/usr/bin:/bin.new: /usr/bin.new: 


Load Manipulation During Peak Time 
A system performs well except for the peak period of 2-4 p.m. 


List several steps you would take to try to improve the 
performance during the peak time. 
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Check the user activity during the peak time. If there is 
any unnecessary activity, recommend to the user that 
they perform that activity during a less busy time. 


Check the files in /usr/spool/cron/crontabs to see if any 
unnecessary processes execute automatically during the 
peak time. 


Check the configuration parameters to see if they can be 
changed to improve the system performance. 


Exercise 5: Testing Tools 


Efficiency of the System Buffer Area 


Use the sar command to look at the efficiency of the 
System Buffer Area for a 5-minute time period. Repeat 
once per hour for several hours. 


The following command looks at the efficiency of the 
System Buffer Area, for 5 one-minute time intervals: 
sar -b 60 5 >/tmp/sarb.out & 


Look at the results of Step 1. Is the System Buffer Area 
being used effectively? If not, what should you do? 


The System Buffer Area is NOT being used effectively if: 
Yrcache < 90" 
If either of these situations is occurring, consider 


increasing the size of the System Buffer Area (the buffers 
and hashbuf configuration parameters). 
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Swapping Activity 


1. Use the sar command to check the swapping activity for a 
5-minute time period. Repeat once per hour for several 
hours. 


The following command looks at the swapping activity, 
for 5 one-minute time intervals: 
sar -w 60 5 >/tmp/sarw.out & 


2. Look at the results of Step 1. Is swapping activity (that is, 
the writing of processes to the swap area) occurring? Is 
excessive swapping occurring? 

Check for the following: 
Swpot/s > 0 indicates swapping activity 


swpot/s > 1.0 indicates excessive swapping activity 


3. If either answer to Step 2 was yes, what should you 
consider doing, if anything? 


If either of these situations is occurring, consider taking 
one or more of the following actions: 


- Decrease the size of the System Buffer Area 
(buffers parameter). 

- Change commonly used commands to shared 
text. 

- Add more memory to the system. 


System Table Usage 


1. Use the sar command to check the usage of the system 
tables for a 5-minute time period. Repeat once per hour for 
several hours. 


The following command checks the usage of the system 
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tables, for 5 one-minute time intervals:/f1 
sar -v 60 5 >/tmp/sarv.out & 


Look at the results of Step 1. Are the tables being used 
effectively? Did any overflows occur? 


The system tables are being used effectively if an 
average of 60 to 80 percent of the available entries are 
used. Overflows are indicated by a positive value in any 
of the -ov fields. 


Based on your answers to Step 2, should the sizes of any of 
the system tables be modified? If so, explain. 


Consider decreasing the size of a table if an average of 
less than 50 percent of the available entries are used (if 
this occurs consistently). 


Consider increasing the size of a table if it overflows at 
any time or if an average of more than 90 percent of the 
available entries are used. 


User Activity 


Set up the System Accounting Utilities to execute for one 
day. 


Check the results in the file /usr/adm/acct/sum/rprtmmdd 
(mmdd is the current month and day). Are any line 
problems indicated? If so, what should you do? 


If the #OFF is more than 4 times #ON for a line, check 
the modem (if any), port, and terminal for that line. 


Are there any users who appear to be abusing the system 
(executing an excessive number of processes, using 
excessive CPU time, or using excessive disk blocks)? If so, 
what should you do? 


System abuse is indicated by excessive values in the # 
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OF PROCS field, CPU(MINS) field, or the DISK BLOCKS 
field. If any system misuse occurs, talk to the user. 


4. Look at the top 10 commands executed. Are any of these 
user-created programs? Should any of these programs be 
changed to shared text or optimized? 


The NUMBER OF COMMANDS field can be used to identify 
the most frequently-used commands. Consider relinking 
these commands so that they are shared text (if they are 
not shared already), and, if possible, consider profiling 
their execution so that the most frequently-used routines 
may be optimized. 


5. Be sure to turn off the accounting package when done, 


since it does take system resources to record this 
information. 
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